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Microsoft 

Where do you want to go today?* 


What do you get when you cross intense industry scrutiny with a burning desire to prove yourself? 

On this occasion, something totally unprecedented. With the latest editions of the Microsoft® Visual Studio® 
development system and Microsoft SQL Server' M 7.0, we believe that Microsoft can now offer customers a 
viable enterprise development platform. And all things considered, we wouldn't dare make such a bold statement 
if we didn’t believe it ourselves. Why are we so sure? For starters we’ve spent the last six years doggedly 
questioning enterprise developers about the tools they require to do their jobs. And everything we learned 








We are here. 


went into designing these two products. You get drag-and-drop database 
design and comprehensive data warehousing capabilities as well as the 
ability to support thousands of users and terabytes of data.Then there are 
the awards we received at Comdex. A response like that can certainly 
bolster one's confidence. To give Microsoft Visual Studio and SQL Server 
the once-over yourself, go to msdn.microsoft.com/vstudio/sql 



© 1999 Microsoft Corporation Aft rights reserved. Microsoft. SQL Server, Visual Studio, the Visual Studio logo and Where do you warn to go today? are either registered trademarks 
or trademarks of Microsoft Corporation In the United States and/or other countries. 1998 Comdex awards: SQL Server 7.0- PC Week' - Best of Show and Best Productivity Software. 
Visual Studio 6.0 -PC Magasm - * Tech meal Excellence and PC Computing* MVP PC Woe A 1 , PC Magazine, and PC Computing are trademarks of Ziff-Davis Inc. 
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Real-world data management solutions 
are typically more complex when one 
examines the pieces, than initially 
recognized by the majority of database 
programmers. All software projects are 
complex puzzles comprised of many 
details, most of which are data-reluted. 
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the speed or control essential for a 
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c-tree Plus'*, by FairCom, has been the 
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THE MASTERPIECE 

YOU CAN MAKE YOUR OWN. 

W ouldn’t it be great to write your app once, then port it to other databases and deploy it—without 
changing a line of code? With DBTools.h++ 3.0, you can! Youll save time and money when you use these 
elegantly designed, tested, and proven C++ libraries instead of writing your own. Now, DBTools.hr + 3,0 gives 
you native access to the newest database versions from Oracle, Microsoft, Sybase, Informix, and IBM, 
plus genera] connectivity through ODBC. 

For mapping relational database structures to C ++ objects quickly, DBTools.hr- 3.0 includes DBFactory, 
Youll appreciate the way DBFactory attends to the details of relational-to-object mapping, allowing you to 
focus on application-specific logic. And whats underlying DBTookh++ 3,0? Tookh++, the C ++ foundation 
class library that's become a de facto industry standard. Joi n the thousands of developers worldwide who 
depend on Rogue Wave components with confidence! 












EDITORIAL 


Lego of My 
Robot 



C ome on, there’s nothing wrong with someone my age wanting LEGOs for a birthday present. 
And as luck would have it, that’s exactly what I got. But not just any LEGOs. No sir-ee Bob, 
a handful of red and yellow r bricks isn’t for me. What I got tvas LEGO’S version of the full 
monty— the LEGO Mindstorms Robotics Invention System, with more than 700 LEGO pieces, 
light and touch sensors, a programmable embedded computer, infrared transmitter, software, and 
enough motors, gears, and wheels to roll out a pretty big barrel. Gee, I can’t tell you what a thrill 
it is to be the envy of every 12-year-old on the block. 

LEGO Mindstorms, developed by LEGO and the Massachusetts Institute of Technology, lets 
you design, build, and program mobile robots using LEGO pieces. At the heart of the system is 
a 16-MHz Hitachi H8/3292 microcontroller with an 8-channel 10-bit A/D 
converter, serial communications interface, timers, and multiple I/O ports. The 
AA-battery powered Minds forms computer, officially called the M ECX” (short for 
"Robotic Command Explorer”), lias 16 KB ROM, 32 KB RAM, and is packaged in a 
w LEGO-enabled” case so that you can attach standard (and not so standard) LEGO 
bricks and beams to it. The RCX (about the size of a standard calculator) stores 
several programs that can be selected and executed via a small keypad and LCD. 

Software development takes place in a host/target environment, whereby you 
build programs on a Windows 95 PC, then download them—via an infrared 
transmitter attached to the PC serial port—to the RCX. Programs are created using 
a visual environment called "RCX Coder which is loosely based on the LOGO 
programming language. With RCX Code, you connect on-screen program blocks 
(instructions) to build programs. Program blacks arc categorized as “commands,” 
“sensor watchers/ “Stack controllers/’ and 4 my commands, 4 Commands let you 
turn on/off motors, specify direction, set speeds, and lhe like. Sensor watchers let 
you specify how the robot responds to touch and light (or temperature and 
rotation, if you have the appropriate add-on kits). Stack controllers let you identify 
the different ways robot pans (motors, wheels, and so on) are to run based on sensor input, timers, 
or whatever. Finally, “my commands 1 ’ allows you to organize stacks into groups. 

Program blocks are added top to bottom; you edit programs by inserting or deleting new blocks in 
between existing ones. The figure above (courtesy of the Mindstorms CD-ROM) shows both the 
development environment and part of a program that controls a robot. In this case, ihe robot is called 
"Track Talker” and uses two motors (one for each wheel) and a light sensor. The robot is designed to 
locate colored objects in its path. It repeatedly beeps as it follows a trail, bui goes silent when it 
encounters a particular color In the Figure, the commands are on the left, the program u tncktlk” is in 
green (A and C control the motors attached to the A and C output ports on the robot), and the light 
sensor is controlled by the blue sensor watchers on the light (the sensor is attached to the robot’s 
input port 2). 

Of course, RCX Code isn't the only way to write Mindstorms programs. LEGO also sells an SDK 
that lets you program the RCX using tools such as Visual Basic. Anti since the RCX is built around 
the Hitachi H8 microcontroller, you have the entire suite of GNU C tools at your fingertips. 

A slew of freeware/,shareware programs have also cropped up, including Markus Noga’s legOS 
operating system (which will be presented in a upcoming issue of DDJ), Dave Baum’s RCX 
Command Center, Barry Rufibers RCX Creator, and the like As you might expect, there are a 
number of Mindstorms web sites, most of which can be found through the official site at 
http;//www.legomindstorms.com/. Likewise, information for building do-it-yourself sensors is 


available at various web sites. 

But Mindstorms is more than a toy. In fact, it has become a very serious, yet inexpensive, 
research tool. At Denmark’s University of Aarhus (htip;//www.daiini.au.dk/'-mic 
/speciale/index.html), for instance, Claus Bjerre, Jes Hvoldai, and Michael Nielsen are building 
“adaptive pet robots” like a robot dog that is capable of intelligent interaction with its 
environment. More specifically, the robot understands spoken commands, determines the source 
of the sound, and responds Lo those commands— depending on its current “mood” (hunger, 
anger, stress, and so on) which, in turn, is controlled by genetically evolved neural networks. 

Right. These guys are building robotic Fidos, and I’m still trying to find a connector peg to stick 
into a 1x8 beam. Thank goodness there are plenty of LEGO experts up and down die block—or 
wilt be as soon as school lets out for the day, 



Jonathan Erickson 

editor-in-chief 

jerickson@ddj.com 
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LETTERS 



3D Modeling 

Dear DDJ, 

Regarding the “News ik Views” entitled 
“Speeding Up 3D Modeling” in the Jan¬ 
uary 1999 issue of DDJ: I am concerned 
about the completeness and accuracy of 
the data sent to the program. If there is 
one scanner from a fixed point gathering 
data on a real-world 3D object, then only 
the surface that ilte fixed point would see 
could be recorded. Everything behind that 
front surface cannot be recorded and, 
therefore, will not exist to the scanner. Are 
multiple scanners from different locations 
around Lhc object being used? Is anything 
being done to scan the inside structure of 
the object? 

I am also concerned about ihe accura¬ 
cy of the data being received* The B2 
Stealth bomber was specifically designed 
to reflect any energy (light, sound, and so 
on) hitting iLs surface from several ran¬ 
dom directions. Thus a scanner trying to 
detect a B2 would receive a weak and 
diffracted B2 signal. Other objects found 
in nature have similar properties* Is any¬ 
thing being done to ensure the integrity 
and accurateness of the signal being re¬ 
ceived by die scanner? 

Lastly, regarding the software itself, does 
the program do any checking on the data 
it receives? Also, does the program just 
work with surfaces or can it also process 
true 3D interior structures? 

James Tl. Sylvester 

Yorba Linda, California 

DDJ replies: You raise some good points, 
James. You can find out more about the 
techniques by contacting Cyra Technolo¬ 
gies at http://www.cyra corn/, 

Bill s Inferno 

Dear DDJ 

When reading A] Stevens’ January 1999 
column, 1 could not help but laugh out 
loud at his woes with the D-Flat 2000 
classes. When I first started programming 
for Windows in 1989 (Windows/386 at 
the time), I too was quite stubborn. I did 
not want to learn the API; heck, there 
were something like 450 functions! But 


when I couldn’t find a decent interface 
library to make my life easier, I was 
forced by circumstances to "hunker 
down" (whatever that means in pro¬ 
gramming terms) and get a grip on die 
Windows API. 

And interestingly enough, that was the 
worsL thing to happen to me as a pro¬ 
grammer but paradoxically the l>est thing 
for my career as a programmer On the 
one hand, I bought into the awful state 
of Windows instruction hook, line, and 
sinker— L abandoned any sort of struc¬ 
tured design in Favor of page after page 
of message-handling switch statements. 
But at the same time my higher program¬ 
ming faculties were dying on die vine, my 
career could not have lieen more assured. 
For as 1 have written lie fore, one’s value 
as a programmer for Windows does not 
consist in one’s abilities as a programmer. 
Rather, one’s value consists in one's ar¬ 
cane knowledge of the many tricks, imps, 
pi 1 falls, and outright bugs and mistakes in 
the Window's API, 

Now I’H confess tiiat l just couldn't keep 
up after Windows for Workgroups. The 
API quickly grew beyond its initial hor¬ 
rendous size to encompass the thousands 
of calls— more if you count all the vari¬ 
ous ActiveX property/method gadgetry 
now tinder the hood—that it is today. 
But I still never lack for work for a sim¬ 
ple reason: Lots of people were as stub¬ 
born as A1 was. And this has left them ut¬ 
terly clueless beyond die confines of MFC, 
OWL, and the tike. Welcome to the entire 
Windows API. Al. I suggest abandoning 
all hope at your earliest possible conve¬ 
nience. Or perhaps I should l>e more ex¬ 
plicit: Welcome to Hell. 

John B. Williston 

wconsu k@pacificnei.net 

Al replies: John, many thanks for your en¬ 
joyable letter Beware. You remind me of 
an old friend who decided, in the early 
1980s, lo establish himself as the world's 
reigning authority on the MS-DOS phe- 
nomenum called die Terminate and stay 
resident" program (TSR). He built an ASM 
library around tills peculiar construct, wrote 
articles, spoke at conferences, gave semi¬ 
nars, and built a company based on this 
specialty. Eventually, when TSEs became 
extinct, he went broke and is, al last re¬ 
port. producing adult web sites for a liv¬ 
ing. I wouldn’t want that to happen to you. 

More On the Crouch-Echlin Effect 

Dear DDJ\ 

There has been more than enough "snake- 
oil” purveyed Lo a relatively unsophisti¬ 
cated and vulnerable target market in the 
course of this Y2K run up. In this partic¬ 
ular instance, principled engineering and 


business practices combined to correct 
the condition you report about the so- 
called “Crouch-Echlin Effect” described 
in your February 1999 “News and Views” 
column. 

1 am a senior systems engineer with 
Compaq and have been a principal in¬ 
vestigator of the Crouch-Echlin Effect 
since it was first called to our attention. 
Our specific interest has been deter¬ 
mining I* whether or not tills supposed 
Y2K phenomenon actually affected any 
Compaq platforms; and 2. what, if any¬ 
thing, such an effect required Compaq 
to do to obviate difficulties for our cus¬ 
tomers. 

In conjunction w ith Intel and others, 
Compaq has conducted exhaustive tests 
that yielded, essentially, no evidence that 
this purported phenomenon affects any 
contemporary ISA PC platform, and most 
certainly none of Compaq’s. Further, Com¬ 
paq does not endorse or offer for sale any 
software fix" purported to address this 
“effect.” 

It is true that an agency of Digital Equip¬ 
ment Carp., prior Lo the acquisition by 
Compaq, was involved with Crouch and 
Echiin in investigating this phenomenon 
and. for a short time, that entity did li¬ 
cense, from Fchlin, the right to distribute, 
for itself, his “software fix.” However, once 
a comprehensive technical investigation 
was conducted within Compaq, we de¬ 
termined that it was inappropriate for 
Compaq to appear to endorse or distribute 
this product and this activity was prompt¬ 
ly terminated. 

Whatever the “root cause" of this phe¬ 
nomenon— still not conclusively deter¬ 
mined, at this writing—there is no evi¬ 
dence to support the proposition that it 
can or should be addressed in software. 
Any platform that displays anomalous or 
disorderly “behaviors” of the character and 
magnitude attributed to this or any simi¬ 
lar phenomenon should simply not be 
used. Applying some “software fix" in a 
vain or misguided attempt to ameliorate 
such a condition is absolutely the most 
inappropriate response. Advocating such 
a response would be quite unethical and 
contrary to the best interests of both the 
advocate and the target audience/market. 

Both Compaq anti Intel have published 
detailed statements concerning the inves¬ 
tigation and significance of the Crouch- 
Echlin Effect, The Intel statement is par¬ 
ticularly useful in debunking most of die 
misinformation that has been bruited about 
on Usenet and the Web concerning this 
phenomenon. Readers can find relevant 
information at both http;//www.Com¬ 
paq, cx>m/year2000/year2000- qa. html and 
http;//www. i ntel. com/support/ yea r2000/ 
under4.htm. 
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Are You Ready for the Next 
BIG THING in 
Java Development??? 

J testf is the only tool 
on earth which finds 
your uncaught runtime 
exceptions for you! 

But don't take our word for it. 

Try it for yourself!!! 

Watch as j testf goes 
through your code, 
automatically finding 
input to flush your bugs! 

Marvel as it reports each 
exception found! 

Wonder how you ever 
got along without it!! 

j testf works on: 

Applets 
Applications 
API’s 

JavaBeans 


any Java Code! 
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0contin tied from page 10) 

I am not an authorized spokesperson 
for Compaq on this or any other matter, 
i did, however, participate fully in the in¬ 
vestigation and disposition of this issue. 
My sole interest, as a DDJ subscriber and 
as an individual well informed about all 
aspects of this whole Y2K issue, is to 
counter the incorrect information about 
Compaq that you caused to l^e published. 
Austin Fletcher 
Compaq Computer Corp, 
a ustin.fietc her® compaq.com 

Myopic about File Names 

Dear DDJ\ 

1 thought that ,l A Java Applet Search En¬ 
gine,” by Tim Kientzle ( DDJ , February, 
1999) was useful and interesting. The tex¬ 
tual comments and highlight that /Java is 
somewhat myopic about filenames, 71 how¬ 
ever, prompted me to respond with some 
information that seems not to be widely 
known. The question of Filenames and 
URLs first came to my attention about a 
year ago on the Java Developer Con¬ 
nection and I answered it with an appli¬ 
cation developed on NT under JDK LI.3. 
1 am sending along new applet code de¬ 
veloped under 1.1.7B on Windows 98. 
(The complete source code is available 
electronically; see “Resource Center," page 


5.) The code has been tested with ap- 
pletviewer, Hotjava, and Microsoft Inter¬ 
net Explorer 401. The applet has not been 
tested on other platforms, but should 
w r ork, assuming a proper JVM imple¬ 
mentation. 

The first piece of information regards 
CodeBase and DocumentBase. For what¬ 
ever reason, getCodeBaseO returns the 
applet path MINUS die applet name, gel- 
DocumentBasef), on the other hand, re¬ 
alms the entire path, including the docu¬ 
ment name. CodeBase can be used 
immediately. If DocumentBase is neces¬ 
sary, one answer is to substring the val¬ 
ue from its beginning to the last instance 
of the file separator character (using the 
system property ‘‘file.separator" or the file 
variable M separator”) and prepending Lhal 
to the file name. 

Second, the File class has a method, 
getCanonicaiPatbf), which will return 
the system dependent form of the file 
path. After properly setting up die URL 
and using URL.getFile(), this method wall 
return the full path properly formatted 
Tor the native system. In the example ap¬ 
plet. I was lazy and used CodeBase . For 
testing purposes, 1 created a directory 
named “data" off the application direc¬ 
tory and created a file named Yest.txt," 
so my entry was “ data/test, txt," After 


pressing OK, the applet shows informa¬ 
tion regarding the bases and path. As Tim 
noted, it is unlikely that the current di¬ 
rectory will be that of an applet running 
from a browser, therefore the complete 
path Is normally needed for a file (as op¬ 
posed to URL) entry. 

Joe Sam Shi rah 
jshinah@ibm.net 

Fid Update 

Dear DDJ, 

Thanks to Randy Leberknight, I have an 
update to niy article “Fid: An Embeddable 
Extension Language Interpreter” (DDJ, Jan¬ 
uary 1999). In the example illustrating 
Conditionals on page 74, the positive | zero 
case underflows die stack. A dup and a 
drop fixes the problem, 

: signum ( x — sign ) 
dup 0< if drop -1 
else 

0= if 0 else 1 endif 
endif 


John Sadler 

joh n _sa d le r@alum, m i t .edu. 
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"I use FontLab 3.0 from PYRUS to 
help 111 / work stand out from the rest. 

And its getting pretty crowded out ther 

Ellen Oawforch Designer 


THE POWER TO RISE ABOVE THE RES 


Do you want to stand 
out from the crowd? 
Then welcare to a 
new era in digital 
type design. It has 
never been easier to 
improve your products 
with state-of-the- 


art type designed 
to set you apart 
from the erowd- 
FontLab — the 
advanced font editor _ 

DispLay high quality 
text on low 


resolution monitors 
with Type 1 or 
TrueType hinting. 
Use the best 
typeface for your 
application with 
simple conversion 


Type 1 and TrueType, 
Remember , all 
typefaces designed 
with FontLab are 
royalty free! 

Developing on Mac 


capabilities between and PC? Maintain a 


consistent appearanc 
cn both platforms 
with TransType, our 
seanless font 
converter- Need 
Windows system 
fonts? Try FOhMaker- 


CaLl Toll Free TODAY to Order FontLab 3 


THE TOOLS TO GET YOU THERE 


CGRritfit 1999. Pyrts ffarth AieHcu, Ltd. Efox 465, ftiUerwiLle, Mb 2110B, USA 


visit PYRUS on the web at wwu,font-bc-< 
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1 Ultimate Technologies * 


* Vibrant Graphics <»# and more 
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SPF/SourceEdil v.2.5 

by Command Technology 
SPF/SE provides ISPF style file 
Management and editing far 
Win-95/98 and WinNT 4 x+ ISPF/PDF 
command set, source coloration, 
ASCII or EBCDIC character set, 
Variable or Fixed records, record 
lengths tD E4K, file sizes to 1GGM, 
Hex display/modify, Mappable keys, 
V macro language. Dialogue 
Definition Language, and much more,. 

Paradise No. 

029 031 O'EU 


‘119 
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DevTrack™ 5.0 

by Tech Excel 

DevTrack is the premier defect- end 
project-tracking tool designed specifically 
for software development teams. DevTrack 
comprehensively tracks and manages all 
defect information, feature requests, 
and development issues. Intuitive and 
powerful, DevTrack provides an integrated 
client/server and intranet/Internet solution 
for enterprise project management. 
DevTrack features universal ODBC support, 
Microsoft Visual SourceSafe integration, 
a scalable client/server architecture, 
advanced e-mail notification, built-in time 
tracking, extensive customization, and 
presentation-quality reports and graphics 
(Formerly Power Track.) 

Paradise No, 

T34 0130-EU 


* 309 . 
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Subscribe Today... at www.pparadise.com 

Islander Insider™ 

Weekly E-mail Newsletter 

Weekly Special Offers & Announcements 


Installation Suites 
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TestTrack 



by Wise Solutions 
Wise Solutions introduces 
a new generation of 
versatile installation suites 
for a wide range of 

developer needs with new features and enhancements that 
make installation scripting, patching, repackaging, and Web 
deployment a snap. 


“ Bulkier tfL-atofcf 
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Install Master 
Paradise No. 
G100710 EU 

* 725 “ 


c-trce Plus 


InstallBuilder 
Paradise No. 
GIG 061D-EU 

‘ 359 * 


litStallMaker 
Paradise No. 
G1D 0910-EU 


by FairCom 

DOS * WINDOWS • NT * UNIX 

• OS/2 * SUN • RS6GQQ • HP90QQ 

• MAC * ONX • LINUX * SCO. 

This well known, highly-portable 

data management package has become 
established as the tool of choice for 
commercial development. Offering 
unprecedented data control, choose from 
direct low level access, ISAM level, or 
ODBC access with the FairCom Server. 
Single User, Multi User, or optional 
Client/Server, ANSI Standard Full Source 
No Floyal tie s, Suppu ris 2S 0/S t 
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Test 


Track 


Simply Belter Bug Truck my 


by Sea pine Software 
TestTrack is the fastest and 
most complete multi-user bug 
tracking solution tor Windows 
95/NT Tracks bug and 
feature requests, customers, users, test configurations, and more. 
Advanced features include e-mail notifications, e-mail bug import, 
duplicate bug handling, release note generation, and much more. 
Distribute TestTrack s standalone bug reporter 
to your customers to automate customer Paradise No. 
support With all of its power, TestTrack S96 0121 -EU 

remains tire easiest bug tracking solution Si CQ 95 
to use and maintain. I jj. 
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VTune Performance 
Enhancement Environment 


by Intel 

YOU WRfTE WE OPTIMIZE 
Your complete software 
performance solution for the 
Pentium' 111 processor from 
the people who designed the 
architecture, 

Intel offers the VTune" Performance 
Enhancement Environment 4.0, a 
complete software performance 
solution to help you develop high- 
performance software for the latest 
Intel Pentium" 111 processor 



Paradise No, 
IZ3 0130 EU 
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I.EADTOOLS Imaging (16/32 ActiveX) Farpoints Spread 5 


by LTAD Technologies, Inc 
LEADTOOLS is a family of 
comprehensive toolkits designed 
to help programmers integrate 
color, grayscale, document and 
medical imaging into their 
applications quickly and easily 
Whatever your programming 
needs, LEAD has a toolkit specifi¬ 
cally designed to give you the best 
imaging technology available with 
the stability and dependability you 
would expect from the imaging LEADer 



Codeivright Pro 


by Premia 
Code wright Pro, the programmers 
editor for Windows, features 
include: fast code browsing with 
Outline Symbols; Difference Editing 
to selectively camfaine changes from 
two revisions; create complex func¬ 
tion calls by just filling out a form; 
infinite extensibility with three 
macro languages; acclaimed Sync 
Integration Technology and solid 
support for Web development 


Great 

Offer! 


7 Offer! + 

Codeyri ght 
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New 

t r n . _ . . . Version 

by Far Pom l Technologies 

Use FarPoint’s Spread 3 to create 
powerful database front-ends, manage 
the display and entry of two billion 
items using the enhanced Virtual 
Mode, print reports using Print Preview, 
perform calculations, import/export 
Excel 97 files 132-bit versions), export 
HTML files (32-bit versions), sort data, 
support OLE Drag and Drop, or take 
advantage of its unparalleled cell-level 
formatting, including twelve built-in cell 
types. Unmatched power, flexibility, and 
speed combine to make Spread the perfect 
component for any application 


Farpoint's Button Objx 2.0 


by FarPoint Technologies 
Button Objx 2,0 enhances any Web 
or Microsoft* Windows' application 
Not only can you replace the 
Windows button control to create 
visually enhanced buttons, you can 
create fully customized active 
buttons and toolbars as well as 
custom-shaped containers. Also 
included is a Balloon control for 
adding customized help balloons 
(tool tips) to your application 
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* 149 “ 


To order—www.pparadise.com or 800-445-7899 
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Quasi! NT ServiceMaster 


by Quasi t Technologies 
NT ServiceMaster is a suite of 
4 powerful controls that lets you 
build, control, and communicate 
with (using included socket 
controls) Windows NT Services, 
quickly and easily. Just think, it 
takes only one method call to turn 
your VB app Into a robust, manageable 
service that can run unattended— 
even with no users togged in. You can 
even monitor and control services on 
remote machines! 



Paradise No. 
Q06 0310-EU 
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Visual Test 6.0 


by Rational Software 
Rational Visual Test 6.0 delivers new 
levels of productivity and power for 
developers and testers deploying 
mission-critical applications on 
Windows 35/NT or the Web. 

Rapidly create tests for applications 
of virtually any size, created with any 
development tool. 

Features and Benefits Paradise No. 

• Web testing [HIMl/DHTML! R04OB1CHEU 

• Tight Integration with 

Microsoft Visual Studio 6 trAA 4^ 

• Active Accessibility Support. *003 B 


Borland C++Builder 4 Pro 


by Inprise 

High-performance ANSI C++ 
Visual Development 

Borland C++Builder 4 Professional is 
the fastest, true-visual ANSI C++ 
development environment 
for building windows client 
applications with next-generation 
fully customizable AppErowser" IDE, 
integrated true two-way visual 
tools, Codelnsighl, CodeSrowser, 
Class Exp lore r r ClassCompleti on, 
ParameterCompletion, and more. 


DevPartner for Java 


by Lornpuware NuMega 
Bet a Suite Deal an a New Suite 
Includes: 

* JCheck—Visual Thread 
and Event Analyzer 

* TrueTime" Java Edition— 
Automatic Performance Analysis 
and Optimization 

* TrueCoverage™ Java Edition— 
Automatic Code Coverage Analysis. 

Save aver *265 off retail price 11 
products purchased separately. 
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Hobo HELP Office 7.0 


by Blue Sky* Software 
The Industry Standard in 
Help Authoring 

Developers worldwide use the 
bestselling RoboHELP Office to create 
professional online Help, documentation, 
and intranet sites. 

* Auto-generate all major Help-based 
formats from one WlnHelp file 

* Create all standard and advanced Help features 

* Shrink suppori costs 

* Shorten the process of creating online Help 

* Y2K Compliant *77 H 

t Price after $ 100 manufacturer's mail-in reba re 9 9** 
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Paradise No. 
B13 0258'EU 


by LogiGear' 

Track your bugs Anytime, 

Anywhere, Any Way you want. 

SQA industry leaders and seasoned 
software-development teams bring you 
TRACKGEAR', the Web-based bug (rack¬ 
ing solution that is remarkably powerful, 
flexible, and simple to use Built for the 
Web from the ground up. TRACKGEAR V es 
designed for your entire product team, 

TechnicaI groups wilt marvel at the power of Paradise No. 
TFLACKGEAR 1 " while non-techmcal staff will L29 011 D-EU 

appreciate how quickly TRACKGEAR' allows gg 



them to get the information they need. 


Visual Intercept CnLerprise 


by Elsinore Technologies 
The only suite of project-oriented 
enterprise bug-tracking tools for 
Microsoft developers. 

Complete Integration with Visual 
Studio—track your bugs without 
leaving your IDE! 

VBA-EUabled for complete customiza¬ 
tion! Status promotion model for 
controlling workflow. Integration with 
Visual SourceSafe, PVCS, ClearCase and 
other SCC systems. Web-based interfaces 
to Visual Intercept are also available! 


Visio Pro 5.0 Upgrade 


by Visio Corporation 
Diagram, document, 
design, and model 
information architectures. 

Visio Professional is the ideal tool for 
manually creating network diagrams, 
reverse engineering ODBC-compliant 
databases, planning software 
development, and mapping Websites. 
St includes more than 1,000 network 
and telecom shapes, plus support for 
IIML 1.1 static structure diagrams. 
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Borland C++Builder Pro Version Upgrade 


Paradise No. B190431-EU *225. flS 

Fujitsu Cotrol Pro Comp Upg 

Paradise No. F22 0211 -EU *457 * 

Digital Visual Fortran Pro Upg. 

Paradise No. D20 0222-EU ’MS. 95 

InstallBuilder Upgrade from Wise 5/6 
Paradise No. G100611-EU 'MS, 9 * 

installShield Professional Upgrade from 5.1 
Paradise No, I2t fm3-EU *289.^ 

MKS Toolkit Upgrade 

Paradise No. M56 0361-EU *M9.^ 

Microsoft MSDN Universal Version Upgrade 
Paradise No. M47 Z721-EU S 1.899.'“' 

MS Windows CE Platform Builder Upgrade 
Paradise No. M471V32-EU s 365. 

Microsoft Visual C++ Pro Ver, Upgrade 
Paradise No. M47 0D21-EU E£2S3 ! 189.' !5 

Microsoft Visual Studio Enterprise Ver, Upg, 
Paradise No. M47 0222-EU *959. 95 

Seagate Crystal Reports Pro Upgrade 
Paradise No. 5O8 013D-EU *169.^ 

True DSGrid Pro Upgrade 
ParadiseNo. A340122-EU M95.® 


‘ Price after manu facturer's $50 mail-in rebate. 
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Shudd you 5ee trie of ll:ase products lifted at a lower 
proe in another ad in this magazine, CAIi US! Well 
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and suppori! 

'Terms of the utter 

■ Offer good through April 30,1999 

* Applicable to pricing on current versions of 
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* April Issue prices only 
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Conventional Wisdom 

Everyone seems to agree that computer 
hardware is a commodity, and the con- 
veritional wisdom for struggling systems 
businesses in newly competitive markets 
is to re locus on software or services. For 
tiie last few years, Silicon Graphics t SGI) 
w as one of these companies, w ith its high- 
powered graphics workstations tilling vic¬ 
tim to aggressive competitors benefitting 
from Moore's Law. 

Rather than succumb to conventional wis¬ 
dom, however. SGi recently launched its Vi¬ 
sual Workstation — a multiprocessor Intel 
machine with a high-performance, propri¬ 
etary bus— to capture the market Tor cheap, 
graphic's, and multimedia workstations. Its 
price/performance numbers seem com¬ 
pelling for customers who have decided to 
go the NT rather than Macintosh, route. 

Contrast SGI with Be, a company that 
has been chasing, this same market. Re 
gave up its hardware business several 
years ago to focus exclusively on its op¬ 
erating system, and the result of its toils 
is BeOS Release 4—an impressive, high- 
performance Operating system that runs 
on Intel and Power PC mad lines. In gen¬ 
eral, BeOS on an Intel machine with a 
standard AGP or PCI bus won't outper¬ 
form NT running on an SGI Visual Work¬ 
station, but there shouldn’t he any reason 
why you couldn't run BeOS on a Visual 
Workstation, Additionally, while the cheap¬ 
est Visual Workstation costs $3395,00, 
BeOS costs $99.95. 

Conventional wisdom says that Be was 
the smarter of the two companies and has 
the better chance of capturing tliis low-aid 
market, But conventional wisdom, in this 
case, is wrong. Other than the lower costs, 
building a new operating system is not 
much different from building a new, pro¬ 
prietary- workstation— the very business 
that SGI is abandoning. The unfortunate 
side effect is that, although BeOS h a fine 
piece of software and has been widely avail¬ 
able to developers for at least tliree years, 
there are still comparatively few applica¬ 
tions that run on the operating system. 

It's too soon to pick winners or losers, 
but It sure looks like SGI has chosen the 
smarter path, So much for oversimplified, 
conventional wisdom. 

—Eugene Eric Kim 

8B Update 

Tile Council of die American Law Insti¬ 
tute (ALI) has decided to hold off pre¬ 


senting Uniform Commercial Code (UCC), 
Article 2D, “Software Contracts and Li¬ 
censes of Information/' at the annual meet¬ 
ing of the American Law Institute for fi¬ 
nal consideration in May 1999. This 
effectively defers any further action until 
at least October 1999. Article 2B is a pro¬ 
posed addition to the UCC intended to 
cover all transactions involving the sale 
and lease of software, databases, and in¬ 
formation. According to National Confer¬ 
ence of Commissioners on Uniform State 
Laws president Gene N. Lebrun, 'The 
Council appeared to need more time to 
consider the beneficial progress on the 
draft made at the last Drafting Committee 
meeting in November [1998.1 and wanted 
to have some opportunity to review text 
and comments more fully than was pos¬ 
sible in December [1998]." For more in¬ 
formation on Article 2B, see the "Editori¬ 
al f DDf, January 1999. 

—Jonathan Erickson 

Coffee, Tea, or PCs 

ft had to happen sooner or later. Sihrbuekx 
coffee conglomerate is jumping to Lire java 
jive by mixing coffee and computers. The 
company has opened “Circadia,” a San 
Francisco-based subsidiary that provides 
Internet access and coffee. 'Hie hardware 
consists of high-speed Ethernet connec¬ 
tions and tabletop telephones with data 
pons. A web kiosk is also available, Ac¬ 
cess is initially free, hut will probably cost 
big (Star)bucks before long. 

—Jonathan Erickson 

,„0r Your Money Back 

Spurred on by the success of Australian 
Geoffrey Bennett, Linux and other non- 
Windows computer users are demand¬ 
ing — and getting in some cases — their 
money back. Bennett, who had just 
bought a new Toshiba laptop, carefully 
read the “End User License Agreement for 
Microsoft Software," which stated that 
users who did not accept die terms of the 
agreement could return the software to 
the manufacturer for refunds. Bennett ul¬ 
timately received a $110.00 refund from 
Toshiba. (See Imp: wwwvnetcrafLcom 
/a u /geoffrey/toshiba, hi ml for the whole 
story.) eMachines is another manufactur¬ 
er apparently honoring the licensing agree¬ 
ment as well. For more information, see 
the Microsoft Refund Newsletter al http:// 
zork,net/re fund. 

—Jonathan Etickson 


How Many Pens on the Head 
of a Pin? 

Researchers at Northwestern University have 
received a patent for what they claim is the 
world’s smallest laser — a Mi CFO cavity 
Semiconductor Laser (Patent 5,825,7991— 
and the laser's Photonic-Well Microcavi- 
ty Light Emitting Device (Patent 
5,790,583). Hie laser will likely be used 
to "write 1 ' microscopic electronic circuits 
by inscribing lines that are a few 
molecules thick onto gold, In such ap¬ 
plications, the ’’ink'’ is typically chemi¬ 
cals (known as “alkanclhiols"} and the 
"paper" is the gold. The technology, 
which is referred to as “dip-pen nano¬ 
lithography ‘ can also be used in other 
forms of microfabrication, nanotechnol¬ 
ogy, and molecular electronics. 

—jo natha n Erickson 

Measuring Up 

The EDN Embedded Microprocessor 
Benchmark Consortium ( EF.MBC) has re¬ 
leased its first set of benchmarks for em¬ 
bedded processors. Addressing the tricky 
and controversial problem of accurate and 
meaningful benchmarks for embedded 
systems, FEMRC has formed several sub¬ 
committees targeting particular markers, 
such as the automotive and telecommu¬ 
nications industries. Each subcommittee 
has developed a number of benchmarks 
based on "real-world" algorithms for its 
particular market. 

Unfortunately, with benchmarks* one 
size does nor fit all A piece of reference 
code Ls usually not an adequate measure 
of how well suited a particular chip is for 
your application, because the code is not 
optimized for that chip. Introducing these 
customizations, however, can defeat the 
purpose of benchmarks, because there Is 
no longer a basis for comparison. To ad¬ 
dress this difficulty, EEMBC has set up a 
Certification Lab to certify benchmark 
scores from licensees who have modified 
the reference code. 

EEMBC currently consists of 24 mem¬ 
ber companies, including AMD, ARM, Mo¬ 
torola, National Semiconductor, and Intel. 
For more information about EEMBC and 
its benchmarks, see http://www.eem- 
bc.org/, 

— Eugene Eric Kim 
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It routinely manages code bases of 
more than 100,000 files, including 
source, document, and Web content. 

It effortlessly scales to hundreds of 
concurrent users. 


take 


1 ft works equally well over the 
Internet, the office LAN and die 
global corporate WAN. 


It features near-zero downtime and 
near-zero administration. 


Please phrase your answer as a question 
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Perforce Software, Inc. 
2420 Santa Clara Ave. 
Alameda, CA 94501 
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The category is 

Software Configuration M 


o It works on more than 30 platforms, 


o It controls the evolution of multiple, 
concurrent development and release 
code lines. 


If you asked “What is Perforce?” you’re clued in to solving your 
toughest code management problems. 

Try a copy from www.perforce.com, and call us for free technical support to help with your 
evaluation. Don't worry about “content-free" salespeople calling you - we believe the Fast 
Software Configuration Management system speaks for itself. 


Don’t jeopardize your software development projects. Use Perforce for SCM. 
















Who you gonna call? 

"John, we need effective IT systems 
that support our business... 

We need it all...businessprocess, 
object and data modeling... 

...and we need it all to work together. 


I need this company to run like a business instead of a science project. 

Far as I know, there's only one software 

company who's figured that out... 

Now i line s one modeling lool that takes yon seamlessly through every phase of development - 
throughout your enlerprise. System Architect 2001, tjorn I’opkin Software, addresses the entire 
modeling needs of your organization, allowing business and I I lo work toward common goals 
and reach mutually beneficial solutions. 

Extensive business process modeling, world-class UML-based object modeling, market-proven 
data modeling and unrivaled structured analysis and design, are all combined in a single, easy-to-use 
product. More than just models, System Architect 2001 also includes forward and reverse 
engineering tor all major languages and databases. Best of all, our shared repository gives 
everybody on your learn simultaneous access to the entire project. \nd the world beyond 
with our web publishing. 

Imagine that! One integrated tool that takes you 
from business process modeling through application 
construction. 

To gel your free Enterprise Modeling white 
paper, call 800-732-0227, or visit us on the web at 
www.popkin.com/whitepaper. Because who else are 
you gonna call? 
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T he right programming language can make all hie difference 
in how easy it is to write a program. This Ls why a pro¬ 
grammer’s arsenal holds not only general-purpose languages 
like C and its relatives, but also programmable shells, script¬ 
ing languages, and lots of application-specific languages. 

The power of good notation reaches beyond traditional pro¬ 
gramming into specialized problem domains. HTML lets us cre¬ 
ate interactive documents, often using embedded programs in 
otiler languages such as JavaScript. PostScript expresses an en¬ 
tire document as a specialized program. Spreadsheets and word 
processors often include languages to evaluate expressions, ac¬ 
cess information, and control layout 
Regular expressions are one of the mast broadly applicable spe¬ 
cialized languages, a compact and expressive notation lor describing 
patterns of text. Regular expressions are algorithmically interest¬ 
ing, easy to implement in their simpler forms, and very useful 
Regular expressions come in several flavors. The so-called 
“wildcards” used in command-line processors or shells to match 
patterns of file names are a particularly simple example. Typi¬ 
cally, is taken to mean “any string of characters," so a com¬ 
mand like 

del *.exe 

uses a pattern “*.exe” that matches all files with names that con¬ 
tain any siring followed by the literal string “,exe”. 

Regular expressions pervade UNIX, In editors, tools like grep, 
and scripting languages like Aw r k, Peri, and Td. Although die 
variations among different programs may suggest that regular 
expressions are an ad hoc mechanism, they are, in fact, a lan¬ 
guage in a strong technical sense— a formal grammar specifies 
their structure and a precise meaning can be attached to each 
utterance in die language. Furthermore, the right implementa¬ 
tion can run very hist; a combination of dieory and engineering 
practice pays off handsomely. 

The Language of Regular Expressions 

A regular expression is a sequence of characters that defines 
a pattern. Most characters in the pattern simply match them¬ 
selves in a target string, so the regular expression Ll abc” match¬ 
es that sequence of three letters wherever it occurs in the tar¬ 
get. A few characters are used in patterns as metacharacters 

Brian and Rob are researchers at Lucent Technologies s Beil Labs 
andean he contacted at buT0cT-kbsconi and mlmbell- labs. com, 
respectively. 
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to indicate repetition, grouping, or positioning, in POS1X regu¬ 
lar expressions, “A” stands for the beginning of a string and 
for the end, so “Ax 11 matches an l£ x" only at the beginning of a 
string, “x$" matches an “x” only at the end, “Ax$ 1 ’ matches L£ x” 
only if it is the sole character of the string, and “A$ 7f matches the 
empty string, 

The character V (a period) matches any diameter, so u xy” matdv 
es “xay,” “x2y r ” and so on, but not “xy” or “xyxy." The regular ex¬ 
pression “A Jr matches a string that contains any single character. 

A set of characters inside brackets “[]" matches any single one 
of the enclosed characters; for example, “[0123456789}" match¬ 
es a single digit. This pattern may be abbreviated “[0-91." 

iTiese building blocks are combined with parentheses for 
grouping, " |" for alternatives, for zero or more occurrences, 
“+" for one or more occurrences, and “? n for zero or one oc¬ 
currences. Finally, s£ \” Ls used as a prefix to quote a metachar¬ 
acter and turn off its special meaning. 

lliese can lie combined into remarkably rich patterns. For ex¬ 
ample, A10-91+ 11 matches a period followed by one or more dig¬ 
its; “[0-9]+\7[0-9]* n matches one or more digits followed by an 
optional period and zero or more further digits; Li (\+1 -) 11 matches 
a plus or a minus (“\+” Ls a literal plus sign); and <£ [eEl(\+1-)?[0-9]+" 
matches an V’ or “E" ftdJowed by an optional sign and one or more 
digits. These are combined in the following pattern that matches 
1 bating- pc>int numtiers: 

f \+14KIQ-93+\.40-91* | V[0-9]+)(TeE](\+1 ->?[()-91+)? 


/* match: search for re anyvhera in text */ 
int match [char *re. char *te£t) 

( 

if (re [0] -a < *') 

return ma t chhie r e (t e+1. text); 
do { /•* must look at empty string */ 

if (matchhere(re* text)} 
return 1: 

J while { : *text++ != 1 \0*); 
return 0: 

) 


Example 1: The function match determines whether a 
string matches a regular expression. 


1 * matchhere: search for re at beginning of text */ 
int matchhere(char ^re, char *text) 

[ 

if (re[0] == r \0’) 
return 1; 
if (re [l] — r * f ) 

return matchstar(re[0], re+2. text); 
if [re [0] && re [l] ^ ‘\0 f ) 

return ♦text — 1 \0 f ; 

if (*text 1 — 1 \0 1 kb (rel®] — '. 1 \ \ re [0] =-*text)) 
return matchherefra+1. text+1); 
return 0: 

3 


Example 2: The recursive function match here does most 
of the work. 


/* matchstar: search for c^re at beginning of text */ 
int matchstar(int c, char *re, char *text) 
t 

do ( /* a * matches zero or more instances *•/ 

if (matchhere(re, text)) 
return 1: 

} while (*text1 = '\0 1 kb (^text+^^c | j c— 1 ,’)) ; 
return 0; 

) 


Example 3: The function matchstar is called when the 
expression begins with a starred character 


A Regular Expression Search Function 

Some systems include a regular expression library, usually called 
“regex” or £< regexp,' 11 However, if this is noi available, it’s easy ro 
implement a modest subset of the full regular expression lan¬ 
guage, The regular expressions we present here make use of 
four metacharacters: “A" * L $ t ” a ty ” and “*/’ with specifying 
zero or more occurrences of the preceding period or literal char¬ 
acter. This provides a large fraction of the power of general reg¬ 
ular expressions with a tiny fraction of the implementation com¬ 
plexity. We’ll use these functions to implement a small but 
eminently useful version of grep (available electronically; see 
' Resource Center, 11 page 5). 

in Example I, the function match determines whether a string 
matches a regular expression. If the regular expression begins 
with i£ A“ the text must l>egin with a match of the remainder of 
the expression. Otherwise, we walk along the text, using match¬ 
here to see if the text matches at each position in turn, As soon 
as we find a match, we’re done. Expressions that contain 
can match the empty string (for example, “.*y” matches l£ y" 
among many other things), so we must call matchhere even if 
the text is empty. 

In Example 2, Lhe recursive function matchhere does most of 
I he work. If the regular expression is empty, we have reached 
the end and thus have found a match. If the regular expression 
ends with <L $," it matches only if lhe text is also at the end. If 
the regular expression logins with a period, it matches any char¬ 
acter. Otherwise, the expression begins with a plain character 
that matches itself in the text. A “A fl or “$” that appears in the 
middle of a regular expression is thus [aken as a literal charac¬ 
ter, not a metacharacter. 

Notice dial matchhere calls itself after matching one charac¬ 
ter of pattern and string. Thus the depth of recursion can be as 
much as the lengih of the pattern, 

The one tricky case occurs when the expression begins with 
a starred character, LL x*7 for example. Then we call matchstar 
with three arguments—the operand of the star (x), the pattern 
after the star, and the text; see Example 3 Again, a starred reg¬ 
ular expression can match zero characters. The loop checks 
whether the lexl matches die remaining expression, trying at 
each position of the texi as long as the first character matches 
the operand of the star. 

Our implementation Ls admittedly unsophisticated, but ii works, 
And, at fewer than 30 lines of code, it shows that regular ex¬ 
pressions don’t need advanced techniques to be put to use. 

Grep 

The pattern-matching program grep, invented by Ken Thomp¬ 
son (the father of UNIX), is a marvelous example of the val¬ 
ue of notation. It applies a regular expression to each line of 
its input files and prints those lines that contain matching strings. 
This simple specification, plus the power of regular expres¬ 
sions, lets it solve many day-to-day tasks. In the following ex¬ 
amples, note that the regular expression used as the argument 
to grep is different from the wildcard pattern used to specify 
file names, 

• Search for a name in a set of source files: grep /print/ 

• Search for a phrase in a set of text files: grep regular expres¬ 
sion' *.txt 

• Filter output from some other program, for example to print 
all error messages: gcc *x | grep Error 

• Filter input to some other program, for example to count non¬ 
blank lines: grep . *.cpp | wordcouni 

With flags to print line numbers of matched lines, count match¬ 
es, do case-insensitive matching, select lines that don’t match 
the pattern, and other variations of the basic idea, grep is so 
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widely used that it has become the classic example of tool-based 
programming. 

Example 4 is the mil in routine of an implementation of grep 
thaL uses match. Ii is conventional that UMX programs return 
0 for success and nonzero values for various failures. Our grep, 
like the UNIX version, defines success as finding a matching 
Mne, so it returns 0 if there were any matches, 1 if there were 
none, and 2 if an error occurred* These status values can be 
tested by other programs like a shell. 

As Example 5 illustrates* the function grep scans a single file, 
calling match on each line. This is mostly straightforward, but 
there are a couple of subtleties* First, the main routine doesn’t 
quit if it fails to open a file* This is because its common to say 
something like 

% grep herpolhode *,* 

and find that one of the files in the directory can't be read. It's 
better for grep to keep going after reporting the problem, rather 
than to give up and force users to type the file list manually to 
avoid the problem file, Second, grep prints the matching line 
and the Ole name, but suppresses the file name if it Is reading 
standard input or a single file. This may seem an odd design, 
but it reflects a style of use based on experience. When given 
only one input, grep's task is usually selection, and the file name 
would clutter the output. But if it is asked to search through 
many files, the task is most often to find all occurrences of some¬ 
thing, and the file names are helpful Compare 
% strings cnormous.dll | grep Error 

with 

% grep grammer **txt 

Our implementation of match returns as soon as it finds a 
match. For grep, that is a fine default. But, for implementing a 
substitution (search-and- replace) operator in a text editor, the 
leftmost longest match is more useful. For example, given the 


/* grep main: search for re In files 
int main (int arge* char +argv[3) 

[ 

int i, mnatch: 

FILE *f: 

if (arge < 2) [ 

fprintf(stderr, "usage: grep pattern [file .,*]\n"); 
exit(2); 

) 

nmatch = 0; 
if Cargo < 3) t 

if (grep(argv [l] , stdin. NOIL)) 

nmatch+t : 

] else t 

for (i ~ 2: i < arge: i++) { 
f - fopen(argv[i] , M r rt ): 
if (f ~ NULL) f 

fprintf {stderr, Tr grep: can't open %s\n", argv[i]): 
continue: 

) 

if (grep(argv[l] , f, argc>3 ? argv[l] : NULL)) 
nnatch+t; 
fclose(f); 

] 

) 

return match == 0: 

] 


Example 4: Main routine of an implementation of grep 
that uses mutch. (Assumes command interpreter expands 
wild cards in file specification on the command line into 
lists of file tiames, UNIX shells exhibit this behavior, 
although MS-DOS COMMAND, COM does noO 



Diamond 


you've seen the rest 
now get the best 


software 


release management 
build management 

impact analysis 
workbench 

jde | 1 environment 

software distribution 


Phone (800) 362-82”) 

(818) 221-2910 Fax: 1818) >>4-2000 

www.DiamondOS.com 

info@DiamondOS.com 


Dr. Doth s Journal , April 1999 


21 



















/* grep: search for re in file .*/ 
int grep[char FILE *f, char *name) 

[ 

int n P nmatch ■ 

char buf[BUFSIZ] ; 

runatch = 0; 

■while (fgets{buf t sizeof bvf. f) ! = NULL) [ 
n = strlen(buf); 
if (n > S 6rS; buf[n-i] == 1 W) 
buffr-l] = ’\0'i 
if {match(re p buf) j [ 
nmatch+t: 
if (name t- NULL) 

printf("%s:" P name); 
printf( M *s\n'\ buf); 

] 

) 

return nmatch; 

} 


Example 5: The function grep scans a single file, calling 
match on each line. 

text “aaaaa, 11 the pattern “a* 11 matches the null string at the be¬ 
ginning of the text, but the user probably intended to match 
all five characters, To cause match to find the leftmost longest 
string, matchstar must be rewritten to be greedy: Rather than 
looking at each character of the text from left to right, it should 
skip over the longest string Lhat matches the starred operand, 
then back up if the rest of the string doesn’t match the rest of 
the pattern. In other words, ii should run from right to left, Ex¬ 
ample 6 is a version of matchstar that does leftmost longest 
matching. This might lie the wrong version of matchstar for 



/* matchstar: leftmost longest search for c*te */ 
int matchstar(int e, char +re p char +text) 

t 

char *t; 

for (t - tart: *t l- 1 \0’ && . (*t = c \\ c == T ,'); t+t) 

do [ /* *• matches zero or more */ 

if (matchhere(re, t)} 
return 1: 

) while {t“ > text); 
return 0; 

1 


Example 6: A version of matchstar that does leftmost 
longest matching. 

grep, because it does extra work; but for a substitution opera¬ 
tor, it is essential. 

What Next? 

Our grep is competitive with system-supplied versions, re¬ 
gardless of the regular expression. For example, it takes about 
six seconds to search a 40-MB text file on a 400-MHz Pentium 
(compiled with Visual C++). Pathological expressions can cause 
exponential behavior, such as bi*a*a*a*a*b 11 when given the 
input “aaaaaaaaac," but the exponential behavior exists in 
many commercial implementations, too, A more sophisticat¬ 
ed matching algorithm can guarantee linear performance by 
avoiding backtracking when a partial match fails; the UNIX 
egrep program implements such an algorithm, as do scripting 
languages, 

Full regular expressions would include character classes like 
ia-zA-23® to match a single alphabetic character; the ability to 
quote a metacharacter (for example, to search for a literal peri¬ 
od); parentheses like ^(ahe)*” for grouping; and alternatives, 
where “abc | def matches “abe” or "def 11 

The first step is to help match by compiling die pattern into 
a representation that is easier to scan. It is expensive to parse a 
character class every time we compare it against a character; a 
precomputed representation based on bit vectors could make 
character classes much more efficient. 

For regular expressions with parentheses and alternatives, 
the implementation must lie more sophisticated. One approach 
is to compile the regular expression into a parse tree that cap¬ 
tures its grammatical structure. This tree is then traversed to 
create a state machine-—a table of states, each of which gives 
the next state for each possible input c haracter. The string is 
scanned by the state machine, which reports when it reach¬ 
es a state corresponding to a match of the pattern. Another 
approach is similar to what is done in just-in-time compilers: 
The regular expression is compiled into instructions that will 
scan the string; the state machine is implicit in the generated 
instructions. 

Further Reading 

j.F.F. Fried! s Mastering Regular Expressions (O’Reilly N As¬ 
sociates, 1997) is an extensive treatment of the subject. Reg¬ 
ular expressions are one of the most important features of 
some scripting languages; see The AWK Programming Lan¬ 
guage by A.V. Aho, B.W. Kernighan and PJ. Weinberger (Ad¬ 
dison-Wesley, 1988) and Programming Perl , by Larry Wall, 
Tom Christiansen, and Randal 1., Schwartz (O’Reilly & Asso¬ 
ciates, 1996). 
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Udi Member 

a m - first intuition when looking at 
an algorithmic problem is to think 
of the whole input and try to find 
a solution for it. We carry with us 
the intuition of the physical world; when 
we try to solve a problem* we have to 
deal with all of it. The incremental 
method is different. It assumes that you 
have already found a solution, and now 
someone gives you a slightly larger prob¬ 
lem and asks you to extend the solution. 
If you can find a general way to extend 
the solution, then you can start with an 
empty input and keep extending it. Con¬ 
centrating on the incremental is often eas¬ 
ier and it leads to powerful techniques 
for attacking problems, 

1 called this method the "induction 
method” in my book Introduction to Al¬ 
gorithms: A Creative Approach (Addison - 
Wesley, 1989), because it employs the 
same principle as mathematical induction. 
Since then, I found that induction intimb 


Udi is a professor of computer science at 
the University of Arizona. He can he 
contacted at udi@cs.arizona.echr. 


dates many people, and using it in this 
context can confuse things, So I’ll stick 
with incremental method” here, which is 
a dearer and more descriptive name. 

The maximum rectangle problem, de- 
scribed wonderfully by David Vandevoorde 



in his article tt+ lhe Maximal Rectangle Prol> 
lemf ( DDJ , April 1998), turns out lo be a 
perfect example to Illustrate the incremental 
method (Vandevoorde referred to the prof> 
lem as the “maximal rectangle problem,” 
but "maximum” problem is more precise, 
beaiu.se maximal usually means something 
that cannot be extended, whereas maxi¬ 
mum means die global maximum.) The in¬ 
cremental method Is not perfect, and it is 
not always the liesl way, but it is applica¬ 
ble most of the time, and it is definitely a 
technique every algorithm designer should 
keep in their arsenal. 


The Maximum Rectangle Problem 

Tile maximum rectangle problem am lie 
summed up as: 

The input: An NxM binary matrix 8 . 

The output; A rectangle in 8 of maximum 

area containing all Is. 

The first issue when trying the incre¬ 
mental method is to define the incremen¬ 
tal. For matrices, there aren’t too many 
choices; either you add a new row or a 
new column, (fill show later that this is 
noL always straightforward.) Let’s try a new r 
row. Assume that you have found the 
largest rectangle in the original matrix, and 
that you are now given one additional 
row. You need to determine if die re is an 
even larger rectangle with the new row. 
That already limits your search. You need 
to consider only rectangles that end at the 
last row. So all the Os in the last row do 
not contribute. That means that you can 
divide the problem into several suhprob- 
lems by looking only at intervals in die 
last row that contain only Is; see Figure 
1. The subproblems are independent of 
one another, so you need to consider only 
one of them at a time. The same solution 
will apply to all of them, 

Looking at each subproblem, you are 
now looking for the maximum rectangle 
that ends at the Iasi row, and you know 
that the last row contains all Is. So you 
need to know, for each column /, the 
length of the bottom block of Is; call it 
C h This kind of information Is easy to 
maintain as you add rows; for each col¬ 
umn, you either increment the bottom 
block lengdi (if the last row r contains a 1) 
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Figure 1: Dividing the problem into subproblems and reducing it to a one- 
dimensional problem . 


(continued from page 26) 
or set il to 0 (if it contains a 0). The di¬ 
vision into subproblems is used here 
mostly for simplicity; you can just as eas¬ 
ily consider the whole row, with the 0s T 
as one problem. Given this information, 
you can now define your problem as a 
one- dimensiona I problem; 

The input: a sequence of integers, 
C} r C 2 , G*. 

The output: the interval (i,jj that maximizes 
die product of the length of the interval 
(j- i) times the minimum numl*er in it, 

(The area of a rectangle of all Is corre¬ 
sponds to such a product; die width of 
die rectangle corresponds to the length of 
die interval and its height corresponds to 
the minimum number in it.) 

The incremental method lets you reduce 
a two-dimensional problem to a one- 
dimensional one. If you want to obtain an 
optimal OCMN) solution for the original 
problem, you will need to solve this one¬ 
dimensional problem in linear time 0(k ). 
Using the incremental method again, you 
assume that you know how to solve the 
problem up to k numbers, and you now 
need to handle die k+l number; call it 
If successful, this will reduce the 
problem one more time and allow us to 
concentrate on just one number. 
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You need to concentrate only on in¬ 
tervals that end at C kr and check how 
CVi can change them to produce better 
intervals. If then the best inter¬ 

val that ends at C* can be extended to 
end at C^ h without changing its mini¬ 
mum number, so it is the best possible 
interval. But, as Figure 2 shows, if 
CV*t<6*j then you cannot easily deter¬ 
mine Lhe best interval. Without ^4+t 3, 
the best interval (2a) consists of the last 
two numbers, giving the product 
min(6 T 5|x2=K), Extending that interval to 
include the 3 (2b) gives min(6 p 5,3fc<3~9, 
which is not better. But since the mini¬ 
mum number is now 3, you can use a 
bigger inLerval (2c), leading Lo a prod¬ 
uct of min{3>6 p 5,31x4=12. If you extend 
it all the way (2d), you get a product of 
min (4,2,3 A3,31x6=12, There is no easy 
way to figure it out by looking at only 
Ck+\ and the best interval up to C k , That 
seems like a failure of the incremental 
method, because concentrating on 
alone does not seem to be sufficient. 

But the incremental method can lx* ap¬ 
plied in many different ways, which is 
why it is so powerful. Incrementing by 
adding one number at a time to the end 
of the sequence is the natural Lhing to do, 
but it is not the only way to increment. 
Maybe instead of incrementing by look¬ 
ing at the last number, (7 fe+1) you should 
look at the first number, C{! In tills case, 
the first number has the exact same ef¬ 
fect as the last number, so this will not 
help. But what about the minimum num¬ 
ber in the sequence, or the maximum 
number? As it turns out, using die mini¬ 
mum number and using the maximum 
number lead to two different algorithms, 
both optimal. 

Start with Lhe minimum number; call it 
m. For simplicity, I ll use m both lo point 
to the number and to its value. How can 
m be involved in the solution? If the best 
interval contains m, then that interval 
might as well contain everything. In oth¬ 
er words, if m is involved Lhen the besL 
interval is the whole sequence. Keep that 
in mind, and check the alternatives. If m 
is not contained in the best interval, then 
the best interval is somewhere to the side 
of m r either to the left or to the right. You 
have now partitioned the problem into 
two independent subproblems, each of 
which can be solved recursively, so the 
problem is solved. In Figure 3, you see 
the interv als corresponding to choosing, 
from top to bottom, 2, 3, 4, 5, and 6. Get¬ 
ting a linear-time implementation of this 
solution is not straightforward, but since 
you spent only a constant lime handling 
m, there is hope, 

Let's try die incremental method con¬ 
centrating on the maximum number; call 
it M. This turns out to be slightly more 
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tricky, but it leads to an easier to imple¬ 
ment algorithm. Again, how can M be in¬ 
volved in the solution? F Ihere are two pos¬ 
sibilities when M is part of ihe interval. 
Either the interval consists of M by itself, 
in which case its area is Mxl = Af r or the 
interval includes one of M*$ neighbors as 
well In the latter case, M will contribute 
no more than its neighbor contributes. So 
if you can figure out which neighbor to 
choose, you can assign Afs contribution 
to that neighbor by specifying that the 
neighbor is worth twice its size, and do 
away with M. If you can do that safely, 
you have an incremental solution, because 
you can continue to handle maximum 
numbers one at a time. 

You allocate a counter to each number 
to indicate how many of its neighbors 
should lie counted when this number Is 
used for the best interval You then re¬ 
move M and increment the counter of one 
of its neighbors (the mystery of which 
neighbor to choose w ill lie revealed in a 
minute). In effect, what will happen is that 
when the minimum number in an inter¬ 
val is considered, all its larger neighbors 
will have been considered by then, and 
their number will be assigned. So at that 
point the smallest number will know' the 
size of its interval. 

Suppose that the numbers are in de¬ 
creasing tinier with the largest on the left. 
The algorithm will take C x as the first 
rectangle by itself, then increment the 
counter of C 2 to 2. In the second step, 
Ct counts twice (since its counter is 2), 
and so its rectangle is worth 2xCV Check 
whether this is larger than the previous 
best rectangle (Cy), and take die maxi¬ 
mum of them. You then assign C z 's 
counter to C 3 which will be set at 3, and 
contribute 3xC 3 and so on. This is the 
simplest case, and in general die algo- 
rithm works just as well. 

Which neighbor to use—the smaller 
or the larger? The answer is the larger, 
because it is the safer choice. Any inter¬ 
val that contains one of M s neighbors 
will ai least contain M and the larger of 
the neighbors (it may contain both neigh¬ 
bors). So by assigning M's contribution 
to the larger neighbor you ensure that M 
will be considered for any interval that 
contains it. An example of using this al¬ 
gorithm for the matrix in Figure i is in 
Figure 4, The con tri hut ion 6 is 1x6. The 
second Ingest Ls 5, whose counter is now 
2, so it contributes 2x5. NexL is 4, which 
assigns its contributions to its neighbor 
2. Next is 3 0 chose the 3 to the right, 
but you could just as well chose die oili¬ 
er one), which contributes 3x3^ When the 
other 3 is considered, its counter is 4, so 
it contributes 4x3=12. The last one is 2, 
whose counter is now r 6, leading to an¬ 
other best solution of 12, 
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The two algorithms suggested by the in¬ 
cremental method are not complete You 
need to carefully design die right data struc¬ 
tures to handle all die operations efficiently. 
The devil is in the details. But the details 
are easier once you have an overview and 
an understanding of the algorithm, which 
you now do. One of die strengths of die 
incremental method is die ease in which 
one gets to an algorithmic idea. 

The algorithm demonstrated in Figure 
4 consists of the following four steps, 
which are related for each number: 

1 . Find the next maximum M. 

2. Check M's current contribution against 
the previous best 

3. Assign M’s counter to its larger neighbor. 

4. Delete Af 

To get a repeated list of maximunis you 
need to sort the numbers. Fortunately, all 
the numbers are in the range of 1 to N 
(since they sum the number of Is in a col¬ 
umn), so you can sort all of them in linear 
time using a simple bucket sort. Finding the 
neighbors of each number am be achieved 
by Jinking all the numbers in a doubly 
linked list, which also lets you delete each 
number. All these operations can lie clone 
in linear time. (The algorithm can lie fur¬ 
ther simplified by noticing that die sort is 


not crucial, because the main step of as¬ 
signing worth can lie performed any time 
a nuoilier Ls larger than txith its neighbors.) 

Conclusion 

The Incremental method is particularly 
useful as a way to arrive at possible new 
algorithms. It can lead the w ay and sug¬ 


gest different approaches. It is not a 
magic bullet, and it will not replace in¬ 
tuition and experience, but it helps to 
develop both. 
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Thread 
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Parallel Algorithms 


Enabling efficient 
interaction between 
threads 


Lalit Pant 


Ilf ith the increasing availability of 
1 A ■ m met lit: multip rocessi ng (S MI } ) 

U V hardware, para! le I a Igorithms are 
f playing a vital role in extracting 
faster performance from computer sys~ 
terns. But white the idea of parallelizing 
algorithms to achieve greater speeds is ap¬ 
pealing, there are practical difficulties that 
need to be overcome before this can be 
done effectively. Chief amongst them is 
the issue of efficient interthread commu¬ 
nication, Mast parallel algorithms require 
some means by which threads can talk to 
each other. An inefficient communication 
mechanism is likely to retard the poten¬ 
tial speed gains of parallelization. 

In this article, 111 examine thread com¬ 
munication mechanisms that may lie used 


Lalit is the chief technical officerfor Atlas 
Software, a cmsultingfirm based in Pitts- 
hurgh, Pennsylvania. He can he contacted 
at ialitp@earthlink.net 



within parallel algorithms. To facilitate 
comparisons I between these mechanisms, 
1 present an abstract problem and discuss 
the different mechanisms in the context 
of this problem. The discussion is based 
on primitives provided by Windows NT. 

The Problem; 

Parallel Graph Traversal 

Performing an operation on the nodes of 
a graph is a problem that arises in a va¬ 
riety of contexts, including downloading 
pages rooted at a web URL up to a spec¬ 
ified depth, performing an operation on 
a set of files in a filesystem, and the like. 
Examples such as these invoive travers¬ 
ing a graph, and running an algorithm on 


each node as it is being traversed. The 
trick is to do the traversal in parallel, Here, 
I will take tip the traversal of a special 
case of a graph — the multiway tree. Dif¬ 
ferences lietween the two are not impor¬ 
tant for discussing usage of thread com¬ 
munication mechanisms within a parallel 
algorithm. 

The first step is to look at the sequen¬ 
tial traversal of a multiway tree. Listing 
One is a tree definition where each node 
contains a list of zero or more child nodes. 
The root node defines the tree. 

Listing Two implements a sequential 
algorithm for breadth-first Cor level or¬ 
der) traversal of a tree using a queue. 
The algorithm starts by putting the root 
of tlie tree into the queue. Within each 
iteration, a node is taken off the queue, 
its children are enqueued, and the node 
is processed. This continues until there 
are no more children; that is, until the 
leaf nodes are reached. Use of a queue 
is what makes this traversal breadth first. 
Using a stack would have resulted in a 
depth-first traversal. 

Now 111 do the same thing in parallel. 
For this. 1 introduce the abstraction of a 
“concurrency engine. ' Instead of directly 
putting nodes Lhat have to be processed 
into a queue, I enqueue them into a con¬ 
currency engine. The concurrency engine 
Is an “active" object tlxat has multiple work¬ 
er threads running inside it to handle re¬ 
quests. Once a node is enqueued into the 
engine, a worker diread processes it in 
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(continued from page 32) 
parallel The concurrency engine is based 
on the class template ConcurrencyEngine, 
defined in Listing Three, The template has 
two template parameters —Request and 
Work, These parameters let you specify a 
background task and contextual data re¬ 
quired by the task to do its job. Work is 
a functor whose function call operator is 
called in a background thread within die 
engine. A pointer to the instance of the 
Request template parameter enqueued into 
the engine widi enque( ) is passed to the 
function call operator. The init method of 
the engine sets up the underlying thread 
communication channel between threads 
calling enquef) on the engine and threads 
running the Work functor. 

So what exactly is a concurrency engine? 
It is an abstraction that provides a mecha¬ 
nism for asynchronous, concurrent execu¬ 
tion of tasks. The template parameters used 
to instantiate an engine let you specify a 
policy that defines what these tasks will do 
and the contextual data required by these 
tasks. You put requests into the engine by 
calling enquei l A worker thread inside the 
engine calls dequei) to receive the request. 
It Lhen calls the Work functor to mn a con¬ 
current task based on this request. How 
the request is dispatched from a thread call¬ 
ing enquef) to a thread calling ciequet) is 
up to the engine. Listing Four implements 
a parallel traversal algorithm that uses the 
concurrency engine. Compare this with List¬ 
ing Two, Enqueuing the root looks the 
same, but what happened to the rest of the 
stuff? Well, it's gone into a Work functor, 
LotAlgo. Hie thread that initiates the traver¬ 
sal just needs to enqueue the root. The 
worker threads running the functor handle 
everything after that. Listing Five shows 
what they do. 

The Lot Algo functor is called by a work¬ 
er thread with the root node of the tree 
as a parameter. It, in turn, enqueues the 
children of this node back into the engine 
to allow a fellow worker to process these 
in parallel. The functor then proceeds to 
run a predefined unit of work on die cur¬ 
rent node. 

With that out of the way, I'll now turn 
to thread-communication mechanisms that 
can be used to build a channel between 
a thread calling Concurrency Engine:: 
enquef) and one calling Concurrency- 
Engine.,dequef ). 

Thread Communication Mechanisms 

Executive objects within the NT kernel 
come in two flavors—synchronizable 
and nonsynchronizable, Synchronizable 
objects can be used to synchronize 
threads. Such objects are either in a sig¬ 
naled or a nonsignaled state during the 
course of their lives. A thread can do a 
wait on these objects. If the object is in 


a signaled state, the thread's wait Ls satis¬ 
fied. Otherwise, the thread blocks until 
some other thread (or an interrupt) comes 
along and sets the object's state to sig¬ 
naled, at which point the thread is awak¬ 
ened by die operating system, A few of 
these NT objects—Mutexes, Events, and 
Semaphores—exist for die sole purpose 
of synchronization. Others serve a differ¬ 
ent purpose, but can be used for syn¬ 
chronization as well Of these, one that 
will be used later is the File object. Criti¬ 
cal sections are lightweight objects pro¬ 
vided by die Win32 subsystem for fast in¬ 
traprocess synchronization. I refer to these 
synchronization objects as “data locks/ 
Another important class of synchro¬ 
nization primitives is “predicate locks." 
Operating systems such as Solaris provide 
a built-in predicate lock known as the 
“condition variable* (see Listing Six), but 
you have to roll your own on NT, A con¬ 
dition variable is Jinked to a predicate as¬ 
sociated with some shared data in your 
program. Condition variables work in con¬ 
junction with external data locks. The 
predicate itself is not part of the condition 
variable. It is up to the threads using the 
condition variable to protect access to the 
shared data associated w ith the predicate 
by using the external lock. If a thread 
wants to examine the predicate to, say, 
check that the predicate is True before 
proceeding, it has to acquire the external 
lock. If it then finds that the predicate is 
False, it can do a wait on the condition 
variable. This releases the lock associated 
with the condition, allowing another thread 
to come along and change the shared 
data— after acquiring the lock. If a thread 
sets the predicate to True, it can do a sig¬ 
nal on the condition variable, waking up 
a thread sleeping inside the condition's 
wait. The signaler then has to release the 
external lock to allow' the waiter to run. 
Condition variables, when used in con¬ 
junction with plain, old-fashioned queues, 
allow the construction of an elegant 
thread- communication mechanism — the 
producer- consu mer queue, 

Producer-Consumer Queues 

Producer-consu mer queues provide a 
powerful mechanism for transferring in¬ 
formation between threads. Consumer 
threads cry to get information from pro¬ 
ducer th reads via a shared buffer. If that 
information is not immediately available, 
they go to sleep until the time that a pro¬ 
ducer signals availability of information. 
Similarly, producer threads try to send in¬ 
formation to coasumer threads. If the in¬ 
formation cannot be buffered, they go to 
sleep until a consumer thread signals avail¬ 
ability of space in the buffer. 

Listing Seven implements a producer- 
consumer queue. The underlying buffer 


Ls protected by a mutex during updates 
in read() and tvritef ). The same mutex Ls 
used to initialize two condition variables 
that signal the not Empty and notFull con¬ 
ditions, which allow consumers to block 
if no information Ls available, and pro¬ 
ducers to block if the underlying buffer Ls 
full. Listing Eight is an implementation of 
Concurrency Engine;; enque() and Con- 
currencyEngina.dequeO using producer- 
consumer queues. 

Though producer-consumer queues 
provide a powerful abstraction for in- 
terthread communication, they have cer¬ 
tain implementation disadvantages. At 
minimum, they require a predicate lock 
to signal the not-full condition, another 
predicate lock to signal the not-empty 
condition, and an external lock to pro¬ 
tect updates to the underlying buffer. The 
order in which consumer threads wake 
up to service requests from a producer 
is also likely to be first- in/first-out when 
operating system-supplied synchronization 
primitives are lieing used. This is not very 
efficient in terms of the availability of a 
thread's working set within a system’s 
memory hierarchy, a point that Ls explained 
in a subsequent section. In addition, a large 
number of consumer threads are likely to 
!x)g down a computation-intensive algo¬ 
rithm. What is required is a mechanism 
for thread communication that minimizes 
locking overhead, allows for intelligent 
scheduling of worker threads, and pro¬ 
vides for control over the number of 
workers running concurrently on a sys¬ 
tem. Enter I/O completion ports, 

I/O Completion Ports 

I/O completion ports are synchroniza¬ 
tion mechanisms that first appeared in 
Windows NT 3,5. To use them, you cre¬ 
ate a file handle for overlapped or asyn¬ 
chronous I/O, associate the handle with 
a completion port, and have your work¬ 
er threads wait on the port. As soon as 
information becomes available on a han¬ 
dle attached to the port, a worker thread 
is woken up to handle the request. Com¬ 
pletion ports have significant advantages 
over other synchronization mechanisms. 
With the other NT synchronization ob¬ 
jects, wailing threads are released in first- 
in/first-out order. With completion ports, 
worker threads are released in last- 
in/first-out order. How does that matter? 
The explanation goes like this. The 
thread that ran last is the one most like¬ 
ly to have its working set in memory. On 
the oilier hand, the thread that has been 
waiting the longest is the one most like¬ 
ly to have more of its working set 
swapped out to disk. Thus, releasing 
waiting threads in Jast-in/first-out order 
is likely to minimize page faults and 
cache misses. 
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(continued from page 34) 

Completion ports also allow control over 
the number of threads associated with a 
port that can execute concurrently. So, you 
can have any number of worker threads 
waiting for requests over a port, but only 
a subset of these, as specified by the con¬ 
currency value of the port, will lie allowed 
to execute concurrently. For example, sup¬ 
pose you have a four-processor system 
and you assign a concurrency value of 
four to your completion port. You start 
eight worker threads to handle requests 
for diis port. Now, five requests become 
available on the port. Four of the work¬ 
ers can kick in and start servicing these 
requests. The concurrency value of four 
will prevent a filth thread from waking up 
and handling the last request. But that's 
okay, because if the fifth thread woke up, 
it would preempt one of the four running 
threads. Your overall throughput would 
probably go down because of the context 
switch overhead this introduces. Having 
the four additional worker threads on 
standby helps whenever a running thread 
does something that makes it block, like 
reading from a disk. The moment tliat hap¬ 
pens, another w orker wakes up and starts 
processing the next request packet pend¬ 
ing in the port. 

I now need to hook up the worker 
threads within the concurrency engine to 
a completion port, and to make the 
enquef) method put request packets into 
the port. Sockets offer a solution. On NT, 
socket handles are native file handles. Us¬ 
ing them, it is laidy easy to hook tilings 
up appropriately, The first step is to as¬ 
sociate a completion port with the engine. 
The engine constructor creates a bunch 
of worker threads to handle requests for 
this port. It also creates a manager thread. 
This thread in turn creates a TCP server 
socket, binds it to a TCP port, and starts 
waiting for connections on this socket, A 
client thread then calls initf) on the en¬ 


gine initO creates a client socket and con¬ 
nects it to the server socket The manag¬ 
er thread within the engine accepts this 
connection and associates the corre¬ 
sponding socket with the completion port. 
Subsequently, a thread may call enquei). 
Hie enqueO method writes to the client 
socket, at which point one of the work¬ 
ers sleeping on the completion port 
wakes up m the deque() method, reads 
the request packet, and services the re¬ 
quest. 

1 now have a parallel tree traversal algo¬ 
rithm that uses .sockets and I/O completion 
ports instead of a producer-consumer 
queue for thread communication inside 
the concurrency engine. An interesting 
feature of this algorithm is that it is pos¬ 
sible to am the cure of the concurrency 
engine on a fast machine on the net¬ 
work, thus speeding up execution of the 
algorithm, 

But w hile this socket-based completion 
port solution is conceptually pleasing, a prac¬ 
tical problem remains for single- machine 
implementations. Request packets reach 
worker threads via kernel memory. In the 
write to the socket inside enquef K the re¬ 
quest packet is copied from user space to 
kernel space. Within dequef ), it is copied 
back into user space. This is a fairly cost¬ 
ly operation. Here, the flexibility of com¬ 
pletion ports kicks in again. As it turns 
out, it is possible to bypass rite usage of 
file objects when using completion ports. 
To do tills, you have to post a packet to 
a completion port. This causes a worker 
thread waiting on that port to wake up, 
with access to the data that was posted. 
This is exactly what is required for the 
tree traversal algorithm. The enquef) 
method posts a nixie to a completion port, 
and a worker thread dequeues this node 
and works on it as before; see Listing Nine. 

Notice the advantages when you com¬ 
pare tltis with the usage of a producer- 
consumer queue. First, the producer- 


consumer queue solution has to employ 
a lock to guard updates to the queue, 
f Fhere is no explicit locking (and the at¬ 
tendant potential for bugs) involved in the 
completion port solution. Of course, there 
is no such thing as a free lunch. Inside 
the kernel, NT w^ould be using a lock to 
manage access to the internal queue as¬ 
sociated with tiie completion port. But the 
kerne! kindling of locking minimizes user- 
mode to kernel-mode switches in the case 
of completion ports. There is only one such 
mode switch within the enquef )/deque() 
functions. In the producer-consumer queue 
case, there are three within each function! 
Second, the producer-consumer solution 
has lo explicitly manage buffer memory, 
and enqueue-into/dequeue-from this 
buffer in a threadsafe manner. Tills is done 
implicitly by the NT kernel in the case of 
completion ports. 

Conclusion 

It is possible lo adjust the underlying 
thread communication mechanism in a 
parallel algorithm without disturbing the 
overall structure of the algorithm, A com¬ 
munication mechanism based on I/O com¬ 
pletion ports turns out to be optimal. It is 
easy to code and is very efficient in terms 
of working set usage, context switches 
(between threads), and mode switches 
(from user to kernel). Here, I’ve looked 
at a case where the operation running 
concurrently on the nixies of a graph can 
work independently on each node. In cas¬ 
es where dependencies betw een nodes 
with respect to an operation do exist, ad¬ 
ditional abstractions are required to syn¬ 
chronize the threads taking part in the ex¬ 
ecution of the algorithm. 
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Listing One 

// Hultiwsy tree definition 
template (class T> c1ei.ee MTree 
t 

public : 

// contains tree elements 
class Node 

f 

public 2 

T& operator *0; 

T* operator ->{): 

private: 

T m.val: 

Vector(Nodem.children: 

) 

// enumerates child nodes of a node 
claaa Enumeration 

E 

public: 

Kodet nextElementO 
bool haaKoreElEments0 

1 

MTreeO : 

“MTree t): 

// returns tree root 


ModcS root(): 

/f returns parent of given node 
Nodefr parent'.NodcS- child)*: 

/f returns child nodes □£ given node 
Enumeration4 childrenfNode& parent): 
private: 

Hode m pRchOt; 


Listing Two 

if Sequential level order traverael 
if Function arguments : 
if X - tree being traversed 

// oper - the operation to be perforated on each node 
tempiate<elsas T, class NodeOp> 

void levelQrdetTraversal{Tree<T >4 t* const Nede 0 p 4 opar) 

[ 

queue. <TreetT>:: Node *> q; 
q. push (&t, root 03 ; 
while E1 q .empty 0 3 
f 

Tree<T>::Hode* node = 3 D q.front ( 3 3 
q popf) i 
aper[*node 1 1 

Tree(T>;rEnumerationfi e - 3 D t.ehildrenE’node); 

(continued on page 3H) 
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(continued from page 36) 

for(; le.hasHorftElenentsO ; ) 

[ 

q. push (&e. na-xtlilement C)) > 

5 

e.freet): 

3 

// Operation to be performed on each node 

// PasB€d ss second template parameter to the function template above 
template <class T> struct NodeOper 
t 

void operator() (Ttea<T^:iHadet node) conet 

t 

tout << *nqde endl; 

3 

}: 

Listing Three 

// Concurrency engine 

template <claaa Request, cIsbb UorkJ class Concur reiic yEnginie 

c 

public ; 

Concur r&RcyEnginetWorlt& w): 
int mitO: 

// put request into engine 
vo id clique (Request • r): 
private ; 

Request* deque(3; // Called by internal threada 
3; 


LotAlgoCT, Do> algo(l. d) r // LotAIgo defined in listing five 
ConcurrencyEngine<Tree<T>:iNode. LotAlgtKT. Do> > q(algo): 
algo .setEngine (&q); 
q.initC): 

q.enque(&t.root f)); 


Listing Five 

H Level order traversal functor 
template <class T, class Do> 
struct LotAlgo 

E 

Ttee<T>& mjtt 
const Doi m. vork; 

ConcurrBncylngine<Tree(T>iiNode, LortAlgD<!I\ Do> >* *_q; 

void operatortJ {Tree<T>iiNode* r) 
l 

Tree<T*>: jEnumerationi e -3D m_t, children(*r); 

// enque child nodes back into the engine 
£qr(: e,hasNoreElejaentS (3: 3 
t 

m_q->enquetba-neitllement f)3: 

) 

// work on the current node 

mjifork(r) E 

e.freef] \ 

) 

Jt 

Listing Six 


// While instantiating an engine, a functor needs to be supplied as the 2nd 
// temp Iate parameter. Its function rail operator is called in the background 
//by the concurrency engine with a pointer to an instance of the first 
// template parameter 

template <class Request> struct SomeFunctor 

t 

void operator() (Request *rj; 


// condition Variable interface 
class Cv 
E 

public : 

Cv(HANDLE lock): 

~Cv(); 

void wait£J; 
void signal!): 

]; 


Listing Four 

// Parallel level order traversal 
// Function arguments : 

// t - tree being traversed 

// d - the operation to be performed on each node 
tempiatetclasa T* claee Do> 

void levelOrdei;TravergalKt(rree<r>& t. const DoS d) 
[ 


Listing Seven 

// Producer Consumer queue 

template telass Mesaage> clean PCQueue 

t 

private: 

HANDLE ■ .lock; 

Cv notEmpty: 

Cv notFull: 
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queue<MesSage} m.queue; 

Eize_t maxSise; 

public] 

FCQueu-a (size .t size=3B15&0) 

: bsHiSize■(aiae3 . e_ 1 ock{GreateNuteMB, 0, 0) ), notEspty (ra_lock). 
notFull Cm— lock) 

C 

3 

’FCQueUe{) 

( 

CldseHandle(m.luuk); 

) 

Message read(void) 

{ 

VaitRorSingleAbj ect (m_Lock, INFINITE) ; 
while (m..queue .empty 0 3 
[ 

notEmptv. wait {.); 

3 

Message result =3D m.. queue, front() : 
m_queue,pop_frent{J: 

nqtfull-signal 0; 

ReleaseHutexIn lock); 
return result; 

3 

void vriteCMeBflBge m) 

C 

VaitPorSingleObject (tl.Iock. INFINITE) ; 
while (m. queue. eiseQ =3D=3D maiSize) 
t 

notFu.Il.wait(); 

3 

queue.push back(tu) ; 
not Empty - e igna 10; 

Ee 1 eausMu i ax i in i oak ); 

2 

3; 


Listing Eight 

// Engine dispatch mechanism using producer consumer queue 
template Cclaas Request, class Work) class ConcurrencyEngine 
[ 

private : 

pCQueue<Request *> m_pcqueue; 

3; 

template <elsas Request n class Work> 

void ConcurrencyEngine<Request. Wurk>:[enqye{Request* r) 

[ 

m.pcQueue.write(r}i 

1 

template <class Request, class Worfc> 

Request* ConcurrencyEngineiRequest r Work*::deque(3 

return m-pc-Queue, read (): 

) 


Listing Nine 

// Engine dispatch mechanism using completion port 

template t class Request, class Work> class CDncurreneyEngine 

C 

private : 

HANDLE H-ioPort: // completion port for enqued requests 
template <c1sbs Request, class Work> 

void ConcurrentyEn|ine<RequBst. Wgrk>;:enque{Request* r) 
t 

PostQueuedGomplerionStatus{m_ioPort r siteof(Request +}, (unsigned! 
long)c. 0); 

} 

template <dses Request, class Work> 

Request* Coi]currencyEng,ine<Reque3t, Wprk>:ideque£J 
C 

DWORD key. read: 

OVERLAPPED *pOv: 

GetOuenedCompletionStatus(m_ioFort, frread. &key h &pOv, -1): 
return {Request *)key; 
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Simulated Recursion 


Working around 
language shortcomings 

Earl Augusta 

I n the early 1960s, C.A. Hoare devel¬ 
oped ihe Quicksort sorting process. 
Quicksort divides ihe data into succes¬ 
sively smaller groups. In itself this d(>es 
not sound very impressive, hut tests show 
that Quicksort can sort large volumes of 
data tens or hundreds of limes faster than 
most commonly used algorithms. How¬ 
ever, there is a problem. 

Quicksort uses recursion, the process by 
which a procedure or a function calls itself, 
Recursion is very powerful in attacking 
problems where Lhe same questions are re¬ 
peated and the same actions are performed, 
but with each set of actions working with 
the result of a prior step. Examinations of 
data structures such as linked lists and trees 
are ideally suited for recursive program¬ 
ming, In languages such as C or Pascal, re¬ 
cursion is allowed, but languages like Cobol 
generally forbid recursion. A way around 
language limitations is to simulate recursion 
in a manner that can be coded in almost 
all programming languages, 

A recursed program examines and acts 
upon data until it arrives at a point where 


Ear! is a senior consultant with Keane 
Inca Boston-based IT consulting firm. 
He can he contacted at earLaugusta® 
co rporate.ge. com . 


logic suggests that there is a new set of 
data, ready to be acted upon by a new 
copy of the program being executed. At 
this point, the program calls itself. Nor¬ 
mally tliis calling passes the new data to 



be processed by the next iteration. Even¬ 
tually, the logic dictates that further recur¬ 
sion Is unnecessary, and the current active 
version of the code falls out the bottom, 
returning to execute the instruction fol¬ 
lowing the one dial issued the call in die 
prior iteration of l lie recursive module. As 
each copy of die code finishes, it transmits 
information back to die calling copy When 
control Is finally passed to the original copy 
of the recursive module, falling out the 
bottom terminates the recursive process. 

Simulating Recursion 

Knowing the process by which recursion 
passes data upward and downward though 
the called modules, you can isolate and 


preserve the variables unique to each re¬ 
cursive step and simply loop a given piece 
of code to achieve simulated recursion. 
Since looping would start the code pro¬ 
cess at the same place each time, you 
must keep a place marker, indicating just 
where to begin the processing of the cur¬ 
rent iteration. 

The data used by each iterative step 
can be in any form and is a function of 
ilie programming requirements. A binary 
switch is probably the best form for a 
place marker. A combination of the re¬ 
quired variable data and a place marker 
form a snapshot of the conditions during 
any step of the recursion. You should con¬ 
struct a table where snapshots can be 
stored, A poiliter to this stack of snap¬ 
shots allows the program to select die ap¬ 
propriate set of values for a particular it¬ 
eration of the recursive process. The 
depth of the stack must be such that it 
can contain all the steps necessary to 
achieve die objective of the program lac¬ 
ing executed 

Simulated Recursion 
in Quicksort Example 

'lhe examples 1 present here demonstrate 
simulated recursion Quicksort in a Cobol 
program, This is one of the most hostile 
and awkward environments in which to 
do recursive programming. The idea is, 
“If we can do it here, we can do it any¬ 
where." The data portion of Quicksort 
would look like Listing One. 

In Listing One, a table of 32,000 100- 
byte entries is the data to be sorted. 
SWAP-ELEMENT and PIVOT-VALUE rep¬ 
resent scratch work areas required to hold 
individual table entries from time to Lime. 
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(continued from page 40) 

The WORKING-INDEXES point to table 
entries and, as such, are full-word inte¬ 
gers. FURST and LAAST are pointers to the 
first and last table entries in a group cur¬ 
rently under consideration. The size and 
location of that group changes constant¬ 
ly during the progress 
of Quicksort. 

HOW-RETURN is the 
place marker enabling 
the program to begin 
processing at the cor¬ 
rect place when reen¬ 
tering the looped code. 

The place-marker con¬ 
cept is critical to en¬ 
abling fixed, looped 
code to emulate recur¬ 
sive processing. 

The TABLE-OF-IN- 
DEXES is a stack of 
WORKING-INDEXES. 

As the program pro¬ 
gresses downward (call¬ 
ing another iteration of 
QUICKSORT) or upward (returning to a 
prior iteration) die values for pointers and 
place markers are saved or retrieved. Every 
txcurrmee witliin die TABLE-OF-INDEXES 
is one set of WORKING-INDEXES. The 
SESSION-INDEX is the pointer to the set 
of values currently being used. LEFT and 
RIGHT-INDEX are working pointers used 
during each phase of Quicksort. 

Listing Two initializes Quicksort. It pre¬ 
sets the stack of working pointers to bina¬ 
ry zero bits. Then, one set of working 
pointers is initialized, with the FURST 
pointer set to point to the first dement 
in the data to lie sorted and LAAST set 
to point to tile last. Setting the HOW- 
RETURN switch to 1 indicates that this is 
a new iteration of die Quicksort code and 
processing should begin at the beginning. 
The SESSION-INDEX is set to I (this will 
lx.” tile first session) and the data is load¬ 
ed onto Lite stack. 

Each iteration of the code in Listing 
Three first pulls data from die stack and 
then puts it into the WORKING-INDEXES. 
The value of die SESSION-INDEX deter¬ 
mines which data is pulled. By controlling 
the values for die SESSION-INDEX and the 
HOW-RETURN switch, you control how 
each program kxip functions. 

The program logic in Listing Four ex¬ 
amines a specific group of table elements. 
Even though the members under con¬ 
sideration change continually, the ex¬ 
amination process is exactly the same; 
hence the application of recursive pro¬ 
cessing. 

The program logic establishes the first 
element to lx a pivot point around which 
other comparisons will be made. Ele¬ 
ments are examined from left to right, 


and from right to left, and element swaps 
are made where indicated. The end re¬ 
sult is dial the pivot element has been re¬ 
located and now divides the group into 
two smaller groups, where all elements 
to the left of the pivot are smaller than 
the pivot, and all elements to the right are 
larger. This produces 
two new; smaller 
groups that are then 
examined in the same 
manner. 

Listing Five pre¬ 
pares the Quicksort 
environment to exam¬ 
ine first the left side, 
and then die right side 
of the two newly cre¬ 
ated strings of data to 
be sorted. When the 
index values have 
been set, the program 
simply calls Quicksort 
again. After Quicksort 
examines both strings 
and returns control to 
tills iteration of the code, the program tests 
to see if this iteration is the first one that 
initiated the sort. If that is the case, the 
sort is complete. If not, the pointer to ses¬ 
sion data is reduced by one and, in effect, 
when Quicksort is called again (see List¬ 
ing Six), control is returned to the prior 
program iteration. 

What is the difference betw een a typ¬ 
ical user sort, where every element is 
compared against every other element, 
and a recursive Quicksort? In large vol¬ 
ume sorting operations, the differences 
are impressive. Recursive Quicksort could 
mean saving minutes or even hours when 
sorting large amounts of data. The re¬ 
cursive process is very powerful and has 
many uses in mathematical analysis. 
Quicksort is only one application of tills 
type of programming logic. 

Conclusion 

While this example illustrates the use of 
a simulated recursion Quicksort in Coho!, 
this process can be used In many other 
types of languages including C and Pas¬ 
cal. The use of the recursive Quicksort 
can greatly reduce the time needed to 
sort large amounts of data, which can lx j 
useful regardless of the programming 
language. 


DDJ 


(Listings begin on page 44.) 


Recursive Quicksort 
can greatly reduce 
the time needed 
to sort large 
amounts of data 
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Listing One 


01 

TABLE-TO-BE-SORTED, 




02 table-entry 

PIC XU00) OCCURS 3200O TIMES- 

m 

SWAP-ELEMENT 

PIC XU00). 


01 

PIVOT-VALUE 

PIC X(100), 


0i 

WORKING-INDEXES. 





02 FURST 

PIC 9(5) 

USAGE 

BINARY, 


02 LAAST 

PIC 9(5) 

USAGE 

BINARY, 


02 PIVOT 

PIC 9(5) 

USAGE 

BINARY. 


02 KDW-RETURN 

PIC 9(5) 

USAGE 

BINARY, 

01 

TABLE-OF-INDEXES 





012 CURRENT- INDEXES OCCURS 

100 TIMES. 


03 FILLER 

PIC 9(5) 

USAGE 

BINARY. 


03 FILLER 

PIC 9(5) 

USAGE 

BINARY. 


m FELLER 

PIC 9(5) 

USAGE 

BINARY. 


03 FILLER 

PIC 9(5) 

USAGE 

BINARY, 

01 

SESSION-INDEX 

PIC 9(5) 

USAGE 

BINARY, 


LEFT-INDEX 

PIC 9(5) 

USAGE 

binary. 

n 

RIGHT-INDEX 

PIC 9(5) 

USAGE 

BINARY. 


Listing Two 

INITIALIZE-SORT. 

MOVE LOW-VALUES TO TAHLE-OE - INDEXES. 
MOVE 1 TO FURST 

HOW-RETURN 
SESSION-INDEX. 

MOVE 32000 TO LAAST. 

MOVE WORKING-INDEXES TO 

CURRENT-INDEXES (SESSION-INDEX}. 


Listing Three 

CALL-qUICKSORT. 

MOVE CURRENT-INDEXES (SESSION-INDEX) TO 
WORKING-INDEXES - 

IF BOW-RETURN = 2 GO TO DG-PIVGT-TO-LAST. 

IF HOW-RETURN = 3 CO TO SEE-IF-WE - ARE-ALL-DONE. - 
IF FURKT NOT < LAAST GO TO SEE-IF-WE-ARE-ALL-DONE, 


Listing Four 

SFLIT-THE-L3ST. 

MOVE TABLE-ENTRY (FURST) TO PIVOT-VALUE. 

MOVE FURST TO LEFT-INDEX. 

COMPUTE RIGHT-INDEX - LAAST + l. 

PERFORM WITH TEST AFTER UNTIL 

RIGHT-INDEX C= LEFT-INDEX 
PERFORM WITH TEST AFTER UNTIL 

TABLE-ENTRY (LEFT-INDEX) >= FIVQT-VALUE 
ADD [ TO LEFT-INDEX 
END-PERFORM 

PERFORM WITH TEST AFTER UNTIL 

TABLE-ENTRY (RIGHT-INDEX) <= PIVOT-VALUE 
SUBTRACT 1 FROM RIGHT-INDEX 
END-PERFORM 

IF LEFT-INDEX < RIGHT-INDEX 

PERFORM EXCHANGE-TWO-ELEMENTS 
END-TF 

END-FERFQEM. 

MOVE FURST TO LEFT-INDEX, 

EXCHAHOT-TtfO-ELEMENTS. 

MOVE TABLE-ENTRY (LEFT-INDEX) TO ENTRY-HOLDER. 

MOVE TABLE-ENTRY (RIGHT-INDRX] TO 
TABLE-ENTRY (LEFT-INPEX). 

MOVE ENTRY-HOLDER TO TABLE-ENTRY (RIGHT-INDEX), 
EXCHANGE-TWO -TCLHMEKTS-EX IT, 

MOVE RIGHT-INDEX TO PIVOT. 


Listing five 

DO-FTKST-TQ-mor. 

MOVE 2 TO HOW-RETURN. 

MOVE WORKING-INDEXES TO 

CURRENT-INDEXES t SESSION-INDEX), 
COMPUTE LAAST - PIVOT - 1, 

MOVE 1 TO HOW-RETURN. 

ADD 1 TO SESSION-INDEX. 

MOVE WORKING-INDEXES TO 

CURRENT-INDEXES (SEES I ON- INDEX) ♦ 
GO TO CALL-QUICKSORT. 


DQ-PIVGT-TO-LAST. 

MOVE 3 TO HOW-RETURN. 

MOVE WORKING-INDEXES TO 

CURRENT-INDEXES (SESSION-INDEX). 
COMPUTE BURST = PIVOT + 1. 

MOVE l TO HOW-RETURN. 

ADD 1 TO SESSION-INDEX, 

MOVE WORKING-INDEXES TO 

CURRENT-INDEXES (SEESION-INDEX). 
GO TO CALL-QUICKSORT. 


Listing Six 


E-mail: orders@mfixom / Fax: 785-841 -2624 

Mail: Dr. Dobb's CD-ROM library 

1601 West 23rd, Ste. 200, Lawrence, KS 66046-2703 

International: Use mail, fax, e-mail, or call 785-841-1631 


SEE-IF-WE-ARE-ALL-DONE. 

SUBTRACT ] FROM SESSION-INDEX. 
IF SESSION-INDEX > 0 

GO TO CALL-QUICKSORT. 

STOP RUN, 
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TheHMAC 

Algorithm 


Key hashing for 
message authentication 

William Stallings 

M essage authentication is a procedure 
that allows communicating parties 
to verify that received messages are 
authentic. The two important as¬ 
pects are verifying that the contents of the 
message have not been altered and that the 
source is authentic The Message Authenti¬ 
cation Code (MAC) is a widely used tech¬ 
nique for performing message authentica¬ 
tion. A variation on the MAC algorithm has 
emerged as an Internet standard for a wide 
variety of applications—HMAC T short for 
"Keyed-Hashing for Message Authentica¬ 
tion.” HMAG was introduced in "Keying 
Hash Functions for Message Authentica¬ 
tion," by M. BeJlare, R. Canetti, and IT 
Krawczyk in Proceedings , CRYPTO 96 
(Springer-Verlag, and at http://wwwcse 
.ucsd.edu/users/mihir). HMAC Ls currently 
an internet draft that has been distributed 
by the Internet Engineering Task Force as 
Request For Proposal (RFP) 2104. 

MAC 

MAC algorithms involve the use of a secret 
key to generate a small block of data, 
known as a "message authentication code/ 
[hat is appended lo [lie message. This tech- 


William is a consultant , lecturer and au¬ 
thor of books on data communications 
and computer networking. His most re¬ 
cent book is Cryptography and Network 
Security; Principles and Practice, Second 
Edition (Prentice-Hall, 1998). He can be 
contacted at http://wwwshore.net/-us. 


nique assumes that two communicating par¬ 
ties, sav A and B, share K as a secret key. 
When A has a message to send to B, it cal¬ 
culates die message authentication code as 
a function of the message and the key. Hie 
message and a xle are transmitted to the in¬ 
tended recipient. The recipient performs 
Lhe same calculation on the received mes¬ 
sage, using die same secret key, to gener¬ 
ate a new message authentication axle. The 



received code Ls compared to die calculat¬ 
ed code; see Figure 1. If you assume that 
only die receiver and die sender know the 
identity of die secret key, and if the received 
code matches Lhe calculated code, then: 

T The receiver is assured that the mes¬ 
sage has not been altered. If an attacker 
alters the message but does not alter 
the code, then the receiver’s calculation 
of the code will differ from the received 
code. Because the attacker is assumed 
not to know die secret key, the attack¬ 
er cannot alter the code to correspond 
to the alterations in the message, 

2. The receiver is assured that the mes¬ 
sage is from the allied sender. Because 


no one else knows die secret key, no 
one else could prepare a message with 
the proper code, 

3. If the message includes a sequence 
number (such as is used with X.25, 
HDLC, and TCP), then die receiver can 
be assured of the proper sequence, be¬ 
cause an attacker cannot successfully 
alter Lhe sequence number. 

A number of algorithms could lie used 
to generate the code. The National Bu¬ 
reau of Standards (NBS), in its publication 
DES Mode of Operation (http://www.nisL 
.gov/itl/divfW/pu bs/ fip 113. htm ), recom- 
mends die use of the DES algorithm. The 
DES algorithm is used to generate an en¬ 
crypted version of the message, and die last 
hits of ciphertext are used as die code A 16- 
or 32-bit code Ls typical. HMAC is a more ef- 
fieient T and increasingly popular, alternative. 

The process just described is similar to 
encryption. One difference is that the au¬ 
thentication algorithm does not need to 
be reversible, as it must for decryption. Lt 
turns out that because of the mathemati¬ 
cal properties of the authentication func¬ 
tion, it is less vulnerable than encryption 
to being broken, 

HMAC 

In recent years, there has been increased 
interest in developing a MAC derived from 
a cryptographic hash code, such as MD5, 
SHAT, or RIPEMD-160. The motivations 
for this interest are: 

• Cryptographic hash functions generally 
execute faster in software than sym¬ 
metric block ciphers such as DES, 

• Library code for cryptographic hash 
functions is widely available. 

• Ihere are no export restrictions for cryp¬ 
tographic hash functions, whereas sym¬ 
metric block ciphers, even when used 
for MAGs, are restricted, 
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(continuedfrom page 46) 

A hash function such as MD5 was not 
designed for use as a MAC and cannot be 
used directly for that purpose because it 
does not rely on a secret key. There have 
been a number of proposals to incorpo¬ 
rate a secret key into an existing hash al¬ 
gorithm. HMAC received the most support. 
HMAC has lx»en chosen as the mandato¬ 
ry-to implement MAC for IP Security, and 
is used in other Internet protocols, such as 
Transport layer Security (TLS, soon to re¬ 
place Secure Sockets Layer) and Secure 
Electronic Transaction (SET), 

HMACDesign Objectives 

Design objectives that RFC 2104 lists For 
HMAC include; 

* To use, without modifications, available 


hash functions. In particular, hash func¬ 
tions that perform well in software, and 
for which code is freely and widely 
available. 

* To allow for easy .replaces bilily of the 
embedded hash function in case faster 
or more .secure hash functions arc found 
or required. 

* To preserve the original performance of 
the hash function without incurring a 
signif can L dcgrada I k m . 

* To use and handle keys in a simple way. 

* To have a well understood crypto¬ 
graphic analysis of the strength of the 
authentication mechanism based on rea¬ 
sonable assumptions on the embedded 
hash function. 

The first two objectives are important 

to the acceptability of HMAC. HMAC 


treats the hash function as a black box. 
This has two benefits. First, an existing 
implementation of a hash function can 
be used as a module in implementing 
HMAC, The bulk of the HMAC code is 
prepackaged and ready to use without 
modification. Second, to replace a giv¬ 
en hash function in an HMAC imple¬ 
mentation, you must simply remove the 
existing hash function module and drop 
in the new module. This could be done 
if a faster hash function were desired. 
More important, if the security of the em¬ 
bedded hash function were compro¬ 
mised, the security of HMAC could be 
retained simply by replacing the em¬ 
bedded hash function with a more se¬ 
cure one (replacing MD5 with SHA-1, 
for example). 

The last design objective in the pre¬ 
ceding list is, in fact, the main advantage 
of HMAC over other proposed hash-based 
schemes. HMAC can be proven secure 
provided that the embedded hash func¬ 
tion has some reasonable cryptographic 
strengths* 

The HMAC Algorithm 

Figure 2 illustrates the overall operation 
of HMAC (see Table 1 for definition of the 
terms in Figure 2). HMAC can then be ex¬ 
pressed; see Figure 3- In other words; 

T Append zeros to the left end of K to 
create a ft-bit string K + (for example, if 
K is <)f length 160 bits and ft = 512, then 
A' will be appended with 44 zero bytes 
0x00). 

2. XOR (bitwise exclusive OR) A F4 with 
ipad to produce the ft-bit block S,, 

3, Append M to S\, 

i . Apply H to the stream generated in 
Step 3. 

5. XOR A" + with opad to produce the ft- 
bit block S fJ , 

6. Append the liash result front Step 4 to S Q , 

7. Apply H to die stream generated in Step 
6 and output the result. 

Note the XOR with ipad results in flip¬ 
ping one-half of the hits of A'. Similarly, 
the XOR with opad results in flipping one- 
half of the bits of K t but a different set of 
bits. In effect, by passing Si and S a through 
ihe compression function of the hash al¬ 
gorithm, you have pseudorandomly gen¬ 
erated mo keys from A'. HMAC should ex¬ 
ecute in approximately the same time as 
the embedded hash function for long mes¬ 
sages, HMAC adds three executions of the 
hash compression function (for S it S ot and 
the block produced from the inner hash). 


HMAC K =H[(K + ©opad)IIH[( K + ffiipad)l[M]|] 


Figure 3: The HMAC algorithm. 
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Term 

Definition 

H 

Embedded hash function (MD5, SHA-1, RIPEMD-16G, and so on). 

M 

Message input to HMAC (including the padding specified in the 
embedded hash function). 

Yi 

ith block of M, 0 < i < L-1. 

L 

Number of blocks In M. 

b 

Number of bits in a block. 

n 

Length of hash code produced by embedded hash function. 

K 

Secret key; if key length is greater than b, the key is input to the 
hash function to produce an n-bit key; recommended length is 5; n. 

K, 

Padded with zeros on the left so that the result Is b bits in length. 

ipad 

00110110 (36 in hexadecimal) repeated b/8 times. 

opad 

01011100 (bC in hexadecimal) repeated b/8 times. 


Table 1: Definition of terms in Figu re 2 . 


HMAC Security 

The security of any MAC function based 
on an embedded hash function depends 
in some way on the cryptographic strength 
of the underlying hash function. The ap¬ 
peal of MMAC is that its designers have 
been able lo prove an exact relationship 
between the strength of the embedded 
hash function and the strength of HMAC. 
The security of a MAC function is gener¬ 
ally expressed in terms of the probability 
of successful forgery with a given amount 
of Lime spent by the forger and a given 
number of message-MAC pairs created 
with the same key. In essence, it can be 
shown that, for a given level of effort (lime, 
message-MAC pairs), on messages gener¬ 
ated by legitimate users and seen by at¬ 
tackers, the probability of a successful at¬ 
tack on ILMAC is equivalent to one of the 
following attacks on the embedded hash 
function: 

L Attackers are able to compute an out¬ 
put of tire compression function even 
with an Initial Value (IV) that is ran¬ 
dom, secret, and unknown to attack¬ 
ers. 

2, Attackers find collisions in the hash 
function even when the TV is random 
and secret. 

In the first attack, you can view the 
compression function as equivalent to 
the hash function applied to a message 
consisting of a single Writ block. For 
this attack, the TV of the hash function 
is replaced by a secret, random value 
of n bits. An attack on this hash func¬ 
tion requires either a brute-force attack 
on the key, which is a level of effort on 
the order of 2 n , or a birthday attack, 
which is a special case of the second 
attack. 


In the second attack, attackers are 
looking for t wo messages, M and AT that 
produce the same hash: H(M)=H(M f ). 
This requires a level of effort of 2 n/1 for 
a hash length of n. On this basis, the se¬ 
curity of MD5 is called into question, be¬ 
cause a level of effort of 2 64 looks feasible 
with today's technology. Does this mean 
that a 128-bit hash function such as JV1D5 
is unsuitable for HMAC? The answer is 
no. To attack Ml>5, attackers can choose 
any set of messages and work on these 
offline on a dedicated computing facili¬ 
ty to find a collision. Because attackers 
know the hash algorithm and the default 
IV, attackers can generate the hash code 
for each of the messages that attackers 
generate. However, when attacking 
HMAC, attackers cannot generate mes¬ 
sage/code pairs offline because at lack¬ 
ers do not know K. Therefore, attackers 
must observe a sequence of messages 
generated by HMAC under the same key 
and perform the attack on these known 
messages. For a hash code length of 128 
bits, this requires 2 Cl4 observed blocks 
(2 73 bits) generated using the same key. 
On a I-Gbps link, you would need to 
observe a continuous stream of messages 
with no change in the key for about 
250,000 years to succeed. Thus, if speed 
is a concern, it is fully acceptable to use 
MD5 rather than SHA-1 or RIPEMD-160 
as fhe embedded hash function for 
HMAC. 

Listing One, the appendix to RFC 2104, 
is sample code for the implementation of 
HMAC with MD5. Listing Two (also from 
RFC 2104) presents test vectors for Listing 
One (trailing ( \0 ? of a character string not 
included). 

DDJ 

(listings begin on page 50.) 
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(continued from page 49) 

listing One 

/* Funct ion r Lmac _rad5 */ 
void 

hmac_ind5(text. t,EK±_len r key, key_lan. digest) 
unsigned char* text; /* pointer to data stream */ 
int text.len: f* Length of data stream */ 
unsigned char* key; /* pointer to authentication key 
int key_leu; /* length of authentication key */ 
caddr.t digest; /* caller digest to b# filled in +/ 

[ 

MD5..CTX context; 

unsigned char k_ipadl65]; /+ inner padding 


key XGRd with ipad */ 


unsigned chat k_opadi65]; /* outer padding - key XORd with oped */ 
unsigned chat fk[1ft]: 
int 1: 

f* if key ia longer than 64 bytan reset it to key=HD5(key) +7 
if (key.len > 64) [ 

HD5_CTX totx; 

HD5Ihit(itet*); 

MDMJpdatetStctJi. key. key.ien): 

M05Final(tk. 6tctx)■ 

key - tk; 
key^len = 16; 

) 

/* the HMAC.JD5 ft ana foot looks Like; 

* ND5(K X.OR opad. MD5(K XOft ipad. text)) 

* where K is an n byte key 

* ipad is the byte 0x16 repeated 64 times 

* opad ia the byte fihcSq repeated 64 times 

* and text is the data being protected 
*/ 

/* start out by storing key in pads */ 
b^ero( k.ipad, siseof k.ipad); 
b£eto( k opad. sixeof k opad); 
bcopy{ key, k_.tpad r key.len); 
buapy( key. k_aped. key.len); 

/* kOR key with ipad and opad Values */ 
for (i=0; i<64; i++) C 

k_ipsd[i] *= 0x36: 
k apadli] ft = 0x5c: 

) 

/* perform inner KD5 */ 

MB5Iiut(&c<jntext); /* init context for Int pass */ 

MDEiUpdate (&catitext, k.iped, 64) /* start with inner pad */ 


MB5lfpdate£kcontaxt. text, text.lsn) ; 
KB5 Final(dige at T icont ext); 
h perform outer KD5 */ 

ME5Init(6c ontext): /* 

KD5Update(^context, k.opad. 64); /* 
HD5Updatc(^context, digest. 16): /* 
KD5Final (digest. icontext); /* 


/* then text of datagram */ 
/* finish up 1st pass */ 

init context for 2nd pass */ 
start with outer pad */ 
then results of 1st bash */ 
finish up 2nd pass */ 


Listing Two 


key = 

£ 

| 

i 

1 

I 

1 

1 

key„lau = 

16 bytes 

data. = 

'Hi There" 

data u „len = 

8 bytes 

digest = 

0x32947 27a 3 mbb 1 c 13 f 4 0 ef B156bfc9d 

key = 

’’Jefe 1 ' 

data * 

"what do ye. want for nothing?' 1 

dnta_len = 

Z8 bytes 

digest = 

0x7 50c 78 3e6ab0b503 eaaB 6e 310*5 db 7 3 3 

key = 

toAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA 

key _ leu 

16 hytefl 

data - 

ftxDDBBDBDDDDBDDDBBBDDB,.- 
., DPBDPBDDDBBEOCEDDMJB. . . 

..DBDDDBDDDBDBDDDDDDBD... 

..CDDDDDBCDDDDD DDBDDDD.., 

..DBBDDDBDBBBDDDBDDBBD 

data_len = 

50 bytes 

digest - 

0x56be 3 45 1 Id144c &Sdbb8e 7 33 f0efib3 f6 

DDJ 
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The PalmPilot’s 
Infrared Port 


Communication 
without cables 


A.J. Musgrove 

T hu PalmPilot was originally designed 
as a Personal Information Manager 
(PTMX Consequently, the software that 
came with it included a date fxx^k, ad¬ 
dress book, to-do list, note-taker, and the 
like. Recent versions of the PalmPilot have 
gone beyond the simple PIM model, how¬ 
ever. T3ie Palm III, for instance, provides 
extensive communications support (in¬ 
cluding Eudora Pro, ccMail, POP3 Internet 
e-mail, and more) and an infrared (IR) port. 
Applications bundled with the Palm 111 
support data exchange over TR. The ex¬ 
change of these data objects is not the 
only application for the IR port. While the 
pod is not powerful enough to act as, say, 
a remote control for a television, it does 
have enough power to support Palm-to- 
Paim communications of most any kind 
of data. In this article, I explore pro¬ 
gramming the TR port on the Palm. In do¬ 
ing so, I present both an IR test applica¬ 
tion and a version of the venerable game 
Battleship that can he played between two 
players via the IR port. For the most part, 
I'll focus on the IR test application, Un¬ 
derstanding how it works makes Battleship 


AJ, is a freelance consultant and mem¬ 
ber of the technical staff at MCI World¬ 
Com. He can he contacted at musgrove@ 
ccorp.com . 


self-evident. The development environment 
I use to implement: these applications is 
Metrowerks s CodeWarrior for Palm Com¬ 
puting Platform Release 5 (available from 
3Com at http://www.palm.com/). The 
source for both the Battleship and IR test 
programs is available electronically (see 
“Resource Center/' page 5X 



The IR Port 

The IR implementation in PalmOS 3,0 
conforms to Infrared Data Association 
(I if) A) sta n da rds (hit p ://www. irda. com/). 
The published protocol consists of a num¬ 
ber of layers, some required and some 
optional; see Figure 1. 

The Async Serial-IR layer, imple¬ 
mented purely in hardware, is a serial- 
style IR interface that supports speeds 
from 9600 to 115,200 bits/sec. The spec¬ 
ification itself supports synchronous 
communication at speeds of up to 4 
bits/sec., but this was not implemented 
on the Palm, 


The IR Link Access Protocol (IrLAP) lay¬ 
er provides reliable da La transfer on a 
device-to-device basis and device discover. 
IrLAP, which corresponds to the transport 
layer of the OSI network model, supports 
a single connection between two devices. 

The IK Link Management Protocol 
(IrLMP) provides multiplexed, session- 
oriented communication on top of IrLAP, 
A component of IrLMP is the Information 
Access Service (IAS). It provides a service 
and protocol database complete with dis¬ 
covery mechanisms. Using IrLMP, a device 
can cany on multiple, noninterfering con¬ 
versations with a peer device. 

The Tiny Transport Protocol (TinyTP) 
is a lightweight transfer protocol built on 
top of IrLMP, If serves as a base for oth¬ 
er higher-level protocols, such as the Ob¬ 
ject Exchange Protocol (OBEX)—the 
only top-level protocol implemented on 
the Palm. OBEX is used by the Exchange 
Manager to transfer records between ap¬ 
plications, such as Addresses, Appoint¬ 
ments, and Applications, Palm vertically 
implemented the protocol layers neces¬ 
sary to implement the Exchange Manag¬ 
er. However, every software layer of the 
protocol, except OBEX, is exposed 
through APIs. 

The Palm's IR Library 

The IR library on (he Palm is implement¬ 
ed as a system library instead of as a seL 
of operating-system entry points. The IR 
library is unusual; its macros and func¬ 
tion prototypes, for instance, are not even 
included when you use Palm.h— you 
must also include irlib,h to have diese. 
The first step of using any system library 
is to locate the library entry point using 
(continued on page 56) 
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Figure /; The IrDA protocol stack , 


(a) 

Err SysLibFind (CharPlrr libName, Word ^refNum) ; 

(b) 

Err IrOpenCVord refnuin. DWord options): 

Err IrClose(Word refnum); 

<C) 

IrStatus IrBind (UInt refNum, IrCormect* con, IrCallBack CallBack); 
IrStatus IrUnbind (Hint refNutn. IrCotinect* con) ; 

(d) 

typedef void IrCallBack) (IrConnect* con, IrCallbackPams* irData) ; 

(e) 

IrStatus IrSetDevicelnfo(Hint refnum. BytePtr info, Byte len); 


Example 1: (a) The SysLibFindO prototype, (h) IiOpenC) and IrCloseO 
prototypes; (c) prototypes for IrBindf) and IrUnbindO; (d) IrCallBackt )’s 
definition; (e) IrSetDeviceC) prototype. 


Name 

Type 

Description 

event 

IrEvent 

Event causing the callback. 

rxBuff 

BytePtr 

Receive buffer for incoming data. 

rxLen 

Word 

Amount of data in rxBuff. 

device Li st 

IrDeviceLisi* 

A device list; the result of a discovery operation. 

packet 

SrPacket* 

Pointer to data packet begin returned. 

status 

IrStatus 

Status of stack 


Table 1: IrCallbackParms structure. 


Event 


Description 


LEVENT_DAT A_IND 
LEVENT_DISCOVERY_CN F 
LEVEIMT_LAP_GON_CNF 

L E V E N T_LAP_COM_ IN D 
L E V E MT_LAP_D 1SCGNJ N D 

LEVENT^LM .CON CNF 

LEVENTJ_M_COMJND 


LEV ENT_ L M_ DI SCON_ IN D 

LEVENT PACKET HANDLED 
L EV ENT_ST ATU S_ I Nl D 


Data has been received and is in rxBuff. 

Discovery completion. Devices are in device List. 

Requested IrLAP connection has been made 
successfully. 

IrLAP connection has come up. 

IrLAP connection has gone down. This means that 
all IrLMP connections are down also 

Requested IrLMP/TinyTP connection has been 
made. Connect data from the peer is in rxBuff. 

Other side has initiated a connection. You should 
respond with IrConnectRsp* Data from the peer 
is In rxBuff. 

irLM P/Tiny TP connection has been disconnected. 

Any disconnect data is in rxBuff. 

A packet is being returned. 

Indicates a status change on the stack. Status will 
contain IR_STATUS_NO_PROGRESS f 
I R_ ST ATU S_LI N K_0 K, or IR_STATUS MEDIA 
NOT_BUSY. 


Table 2: Events for the IrCaJibackC) function. 


(continued from page 52) 
SysLibFindO. Example 1(a) is the Sys- 
LibFindt) prototype. 

The UbName parameter is the name of 
the library you are trying to locate. The 
name is defined as irLibName in irlib.h. 
refNum is the library handle reference 
number and is a return value of this func¬ 
tion. It must be used in all subsequent 
calls into the library. 

just like die rest of the Palm Ill s Palm¬ 
OS 3-0 operating system, the IR library is 
event based. However, it does not use 
the standard event queue mechanism that 
everything else on the Palm uses. Instead, 
you must give the library the address of 
a callback function. Tills function is called 
to respond to every event for a commu¬ 
nications session. 

IrOpen( ) must be called before using 
any other IR library function. This func¬ 
tion allocates the global data areas and 
allocates system resources. When you 
are finished with the IR library, call Ir- 
Closet). These arc usually called in the 
StartApplicationt) and StopApplicationO 
functions, respectively. Example Kb) 
shows the prototypes for IrOpenf) and 
IrCloseO, The options parameter of 
IrOpeni) specifies the desired eonnec- 
t i o n s p e e cl. irOp e n Opt Speed9600( ), 
irOpenOptSpeed57600f), and irOpenOpt- 
SpeedJ15200() request that connections 
be (jpened at speeds of 9600, 57,600, or 
115,200 bits/sec, respectively. 

The connection phase of the com¬ 
munication introduces the notion of 
client-server. Once the connection is es¬ 
tablished, the two sides are in a peer¬ 
like relationship. The server is the pro- 
cess waiting for a connection. It can go 
about other tasks while waiting for an 
incoming connection request. The client 
Is the process Lhat initiates die connec¬ 
tion. Data can be transferred during the 
connection-setup portion of the con¬ 
versation. This is useful for doing things 
such as exchanging hardware IDs or oth¬ 
er setup information (which I do with 
Battleship). 

As with most protocols, you must 
know what you want to connect to be¬ 
fore actually connecting. The identifying 
unit for conversations is the LSAP selec¬ 
tor, In both the IR test application and 
Battleship, 1 exchange the LSAP selector 
during device discovery* i do this using 
the device-information feature. The lo¬ 
cal LSAP selector for the client is obtained 
during the protocol stack-binding phase 
of the application, which also sets up 
the callback function. The application 
must issue an IrBindf) for each sepa¬ 
rate conversation it w ill cany on. Once 
an application is done with the connec¬ 
tion, it should call IrUnbindO to remove 
the connection from the protocol stack. 
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(continued from page 56) 

Example 1(c) presents the prototypes for 
IrBincK) and IrUnbincK). 

F rhe JrBindC) call registers a connection 
with the protocol stack, ft expects three 
parameters; the library reference number, 
a pointer to a connection structure, and 
a pointer to the callback function for the 
connection. The reference number is the 
number that came from the IrOpenO call. 
Example 1(d) is IrCaUBackf )'s definition. 

All events from the library are sent to 
the callback function. 'Fable 1 shows the 
structure of the IrCallbackParms data 
structure, while Table 2 presents the dif¬ 
ferent event types that the IrCailbackQ 
routine can receive. 

The JrBindf) function also fills in the 
llsap field in the IrConnect structure. This 
is the local LSAP selector. The only field 
in IrConnect that should have set users is 
rLsap. This is the remote LSAP selector for 
the connection All other fields in this 
structure are for system use and are 
changed by the system or macros. 

With a connection bound to the stack, 
the next logical thing to do is set your de¬ 
vice info—the information that's returned 
to the other device during its discovery. 
I use a 1-byte device information string 
that is the local LSAP selector. Example 
1(e) is the prototype for the IrSetDeincef) 
function. 

Client or Server? 

Battleship’s Start Application! J function 
(see Listing One) implements all of the 
steps covered to this point. This puts you 
in a position to act as either a client or a 
server later on. 


Once you have a connection entry on 
the protocol stack, you can go forward 
as either a client or server. A server is 
easier—you just wait for the callback 
routine to be activated by an incoming 
connection request. As a client, you must 
do some connection-setup w r ork. 

The first task is to Find out to what you 
are going to connect. IrDiscoverRetf) starts 
tile discovery' process. Example 2(a) ts the 
prototype for this function. Like most of 
die IR library, this routine is asynchronous. 
The successful return of this function 
means that the discovery process has been 
started. It is not completed until an event 
is sent to the callback function with the 
results as an LEVENT_DISCOVERY_CNF 
event. Once the discovery process is com¬ 
pleted, die device list will be contained in 
the demceList field of die IrCallbackParms 
structure. The device list is of type Ir- 
DeinceList: see Table 3- 

From the device list, you can obtain 
device addresses and LSAP selectors of 
prospective peer connections. You can 
then go about establishing a connection. 
Because all IrDA communication proto¬ 
cols are built on top of IrLAP, the first 
step in communication is starling the Ir¬ 
LAP connection. The 32-bit device ad¬ 
dress can be found in the device list re¬ 
turned from the discovery operation. 
The device address is contained In an 
IrDevicelnfo structure; see Table 4. This 
connection is started using IrConnect- 
Irlapi ); see Example 2(b). This opera¬ 
tion cannot run after an IrEHscoverReqf) 
until an LEVENT_STATUS is received 
with a status of IRJ>TATUS_MEDIA 
_NOT_BUSY. 


The return value from this function 
should be IR_5TATUS_ PENDING. This 
means that the connection request has 
been initiated. This does not mean that 
the connection will fail or succeed. To de¬ 
termine this you must wait for the call¬ 
back to be sent an event. If die return val¬ 
ue is IR_STATUS_MEDIA_BUSY, then 
there is already an active connection or 
discovery process happening on die de¬ 
vice. If die connection is completed suc¬ 
cessfully, an LEVENT_LAP_CON_CNE 
event is sent to die callback function. An 
LEVENT_LAP_DISCON_IND is sent in the 
case of failure. On the server side, die call¬ 
back function in the application is called 
for the event LEVENT_LAP_CON_IND. 
This is the indication to the server drat the 
LrLAP connection has come up. 

Either die client or server can terminate 
the IrLAP connection with a call to IrDis- 
connectIrLap(). Example 2(c) presents its 
prototype. If IrLAP ts disconnected, die 
event LEVENT_LAP_DISCON_lND will be 
sent to all hound IrConnect structures in¬ 
dicating that the connection has gone 
down. This means dial all active LMP and 
TinyTP connections are also terminated. 

There are two possible return values 
for this function. TR_STATUS_ PEN DING 
means that the disconnect request has 
been successfully submitted. The callback 
function will be called once the request 
lias liecn completed, 1R_STATUS_NC_LA1 J 
means there was no IrLAP connection to 
terminate. 

The IR Test Application 

When running die iK test application, you 
must first select one of the Palm devices 
to be your client, and the other to be the 
server. Start the application on both de¬ 
vices, You should see a screen like Fig¬ 
ure 2. The buttons represent different ac¬ 
tions dial can lie taken against the IR stack, 
and the Send line is where you can enter 
data to send to the peer once the con¬ 
nection is up. 

On both devices, bind the connection 
to die protocol stack by pressing the Bind 
button. Next, on die device that you se¬ 
lected as the client, execute a discovery 
operation by pressing Discovery, Once 
you have an S_ MEDIA _NOT_BUSY evait, 
start the IrLAP connection by pressing Ir¬ 
LAP1 Both the client and die server are giv¬ 
en notification that the connection came 
up. From either device, choose to dis¬ 
connect the IrLAP connection by pushing 
IrLAP again. Notifications are then received 
by lx>th sides. 

With die IrLAP connection in place, you 
are set to start one of the higher-level 
protocols—IrLMP or TinyTP. Deciding 
w hich connection you would like to start 
is simple—you just set the parameter in 
the connection structure. For the purpose 


(a) 

IrStatus IrDiscoverReqfUInt refNum, IrConnect *con); 

(b) 

IrStatus IrConnectlrLap [Hint refnum, IrDeviceAddr deviceAddr); 

(C) 

IrStatus IrBiscoruiectlrLap (tflnt refnum) : 


Example 2: (a) IrDiscoverReqQ prototype; (b) stalling a connection using 
lrConnectlrLapf); (c) Ei DisconnectlrLapO's prototype. 


Name 

Type 

Description 

nltems 

Byte 

Number of devices found. 

dev 

Array of IrDevicelnfo 

Information about each device. 


Table JL* IrDev iceList structure. 


Name 

Type 

Description 

h Device 

TlrDeviceAddr 

32-bit address. 

ten 

TByte 

Length of device information. 

xid 

TArray of Bytes 

Device information. 


Table 4: IrDeviceAddr structure. 
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of this example, I'll use IrLMP. Remember 
that the client and the server must be set 
the same, so they wiU both have to set the 
protocol before the connection is started. 
The protocol type is set by using the IrSet- 
ConTypeLMPi) or IrSetCon TypeTTPO 
functions; see Example 3(a). 

Once you have set the connection 
type, everything else about the protocol 
is automatic. No matter which connec¬ 
tion type you are using, the relevant 
events will begin with LEVNET_LM and 
there is no difference in the functions 
used to manipulate the connection. The 
client initiates a connection to its peer 
with a call to IrConnec£Req(); see Ex¬ 
ample 3(b). The refNum is the library ref¬ 
erence number; just as in all the other 
calls, con is a pointer to a connection 
tliat has been bound to the protocol stack 
and has the connection type and rLsap 
selector set. packet is a pointer to the 
data packet that will be sent to the oth¬ 
er side along with the connection request. 
Even if you do not want to send data to 
the other side, packet must point to a 
valid IrPacket structure, credit is the 
amount of credit that will be advanced 
to the other side and Is only valid for 
Tiny IT connections. Since it will be AND- 
ed with 0x7f, the value must also be less 
than 127 or results will be undefined. 


There are three possible results of a call 
to the IrConnectReqi) function: 

1. IR_STATUS_PENDING means that the 
connection request has been successful¬ 
ly submitted and the results w iU be sent 
as an event to the callback function. 

The IR library on 
the Palm is 
implemented as a 
system library 


2. IR_5TATU5_FAILED is an indication of 
the rejection of the connection request. 
A connection request could be reject¬ 
ed because the packet size exceeds 
1 R_MAX_CON_PAC KET for LMP con¬ 
nections or 1 R>L«JITP_CON JACK¬ 
ET for TinyTP connections. The con¬ 


nection request could also be rejected 
if the connection is already connected 
or the IrConneci structure is not bound 
to die stack. 

3. lK_STATUS_NO_IRLAP w ill be returned if 
there is no established MAP connection. 

Whether or not the connection suc¬ 
ceeds, the connection Information pack¬ 
et is sent to the callback function with the 
event LEV E NT_ PACKET_ HANDLE D, This 
is important because the memory occu¬ 
pied by packet is owned by the stack un¬ 
til this event is sent. If you use this pack¬ 
et before you get this event the results will 
he undefined and probably unwanted. 

Once the connection request has l^een 
processed, the results will be sent to the 
callback function as an event. An event of 
LEVENT_kM_DI5C0N_IND indicates tliat 
the connection failed, LEVENT_LM_CON 
_CNF indicates that the connection suc¬ 
ceeded and the IrCaUbackPanns structure 
will contain data relumed from the other 
side as part of the connection response. 

An LEVENT_LM_CON_IND event is 
generated on the device tliat receives the 
connection request. The connection in¬ 
formation from the peer device is includ¬ 
ed in the IrCallbackParms structure. To 
accept the connection, the application 
should issue an IrConnectR$p()\ see 
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"GREAT, GREAT product, Keep up the good work!" - Craig N. 

"Thanks for your great tools and service!!" - Larry O. 

"And by the way, your case code is really nice. That is a genuine computer geek logic 
trick." - Tom R. 

"This compiler has saved me a great deal of time and I like working with it." - Gus M. 
"Thanks again for the excellent quality of your tools and technical support." - Oc/e M. 
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HI-TECH Software has a rarr^e of ANSI C cross-compilers for most popular microcontrollers, 
including 8051, PIC, 6805, Z80, 68HC11,68000, XA. Put some highlights in your programs 
call now for more information or visit our web site. We have resellers in many countries. 


HI-TECH Software 
7830 Ellis Rd Ste 105 
Melbourne FL 
32904 USA 


www.htsoft.com 
sales@htsoft.com 
Ph. 800 735 5715 
Fax 407 722 2902 
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Example 3(c), This looks similar to the /r- 
ConnectReq parameters, and each param¬ 
eter has the same meaning. The packet 
parameter is the data that will l>e returned 
to the peer to accept the connection. You 
cannot use the packet until you receive 
the LEVENT_ PACKET_ HAN DLED, 

Use the IR test application to experi¬ 
ment with IrLMP, First, you must bind a 
connection, then do device discovery from 
the client, and finally start an MAP con¬ 
nection, Only then can you start an IrLMP 
connection. 

Once you have die connection estab¬ 
lished, you will probably want to have a 
conversation. This is accomplished by us- 



Figure 2; Running the IR test 
application. 


ing the IrDataReqi )\ see Example 3(d), 
This function transfers a data packet to 
the peer over the existing connection. The 
maximum size of die data packet can be 
found using IrMaxTxSizef). You must 
check IrMaxTxSizef) for each connection, 
as each one could have a different maxi¬ 
mum packet size. 

The reJNum parameter is the library ref¬ 
erence number and the con parameter is 
die pointer to die IrConnect structure rep¬ 
resenting the connection. The packet pa¬ 
rameter is a pointer to an IrPa eke! struc¬ 
ture which contains the data to be sent to 
the peer. The possible return values of /r- 
DalaReq are IR„STATUS_PENDING or 
TR_STATUS_ FAILED. 

I R_STATUS_PENDING indicates that the 
request lias been accepted by the stack 
for delivery. Once the packet has been 
delivered, the callback (unction receives 
the event LEVENT_PACKET_HANDLED 
and die packet Ls in the packet structure. 
1R_STATUS_FAILED could he returned if 
the IrConnect structure is not bound to 
the slack, die packet exceeds the maxi¬ 
mum size, or the IrConnect structure does 
not represent an active connection. 

When data is received, an LEVENT 
J)ATA_IND event is generated. The rxBuff 
and rxten poraimeis contain the received data, 
lliere is no response [hat should be sent to this 
event, as die slack lias already handled the re¬ 
ceipt acknowledgment. 


The IR test application can be used 
to demonstrate the data transfer. To use 
it, first establish an IrLMP connection 
to a peer. Then, enter the string you 
would like to transmit into the Send 
field and press the Data button, The 
data will appear in the Rec field on the 
other device. 

During processing, it may be neces¬ 
sary for an application to stop receiving 
data. If you are using IrLMP and only one 
connection exists, you can set the busy 
state on the protocol. If more than one 
connection exists, never set the busy state. 
Likewise, never set the busy state for 
Tiny FP. Busy Ls represented by the device's 
transmission of Receive Not Ready (RNR) 
frames. The IriocalBusyO function sets 
and unsets the busy state. Its prototype is 
in Example 3(e), The Hag variable should 
be True to set busy, and False to unset it. 

There are five functions provided that 
view different aspects of the protocol 
stack. Example 3(f) presents their pro¬ 
totypes. All of these functions expect 
the library reference number, and /r- 
MaxRxSizei ) expects the connection to 
which you are referring. The trlslap- 
Con nectedf ) function returns True if 
there is a currently active IrLAP con¬ 
nection. IrlsMediaBusy( ) returns the 
busy status of the medium. If the medi¬ 
um is busy, any connection or discov¬ 
ery requests would fail, IrIsNoProgess() 
returns True if there is no progress be¬ 
ing made on the IrLAP connection. If 
the peer device is removed from the 
transmission range of the IR port, then 
progress could cease on data transfers, 
MsRemoteBusyi) returns True if the peer 
device is currently transmitting RNR 
frames indicating that it does not wish 
to receive data. JrMaxRxSizef) returns 
the maximum data packet size that you 
can expect to receive. The value is valid 
only for the connection used in the func¬ 
tion call. 

Testing the IR Connection 

The final part of the Palm's ER API involves 
testing. You can initiate a test packet to 
tile peer device to see the link status. This 
is done using the IrTestReqO function; see 
Example 4, The TEST packet can only be 
sent when the stack is in the Normal Dis¬ 
connect Mode (NDM) state. Generally, tliis 
means that IrLAP cannot be connected 
and discovery operations cannot be in 
progress. 

The refNutn parameter is the library 
reference numher. The devAddr param¬ 
eter is the 32-bit address of the device 
to which the test frame should be trans¬ 
mitted, con is a pointer to an IrConnect 
structure whose callback Function will be 
the recipient of the test status, packet is 
a pointer to an frFacket that will be sent as 


(a) 

void IrSetConTypeLMP (IrConnect* con): 
void IrSetConTypeTTF (IrConnect *con); 

(b) 

IrStatus IrConnectReq(UInt refnum* IrConnect* con. 

IrPacket* packet, Byte credit): 

(c) 

IrStatus IrConnectRsp (Hint refnum* IrConnect* con. 

IrPacket* packet, Byte credit): 

<d) 

IrStatus IrDataReq (Hint refnum, IrConnect* con* IrPacket* packet): 
Word IrMaxRxSizefUInt refnum* IrConnect* con); 

(e) 

void IrLocalBusy (Hint refnum, BOOL flag); 

« 

BOOL IrlsLapConnected (UInt refnun); 

BOOL IrlsMediaBusy (UInt refnum): 

BOOL IrlsNoProgressCUInt refnura); 

BOOL IrIflRemoveBUBy(UInt ref min); 

Word IrMaxRxSizeCUInt refnum, IrConnect* con); 


Example 3' (a) Using the IrSetConTypeLMP or IrSetConTy peYI P functions; (b) 
initiating a connection peer with a call to lrConnectReq; (c) accepting the 
connection via IrConnectRsp; (d) imitating a conversation using IrDataReq, (e) 
IrLocalBusy prototype; (f) prototypes offunctions available for protocol stack * 


IrStatus IrTestReq (UInt refnum* ItDeviceAddr devAddr* 

IrConnect* con* IrPacket* packet); 


Example 4: The IrTestReq function. 
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the test data, There ate three possible return 
values: 

1. IR_STATUS_PENDING means that the 
test packet has I teen accepted by the 
protocol stack. The callback function is 
sent an LEVENTJTESTJ3 NF once the 
test has been completed Tile status Held 
contains IR_STATUS_SIJCCESS to indi¬ 
cate success or IR_STATUS_ FAILED to 
indicate a test failure. 

2. HLSTATUS_MEDIA_BUSY means that 
the media is not in the NDM state and 
cannot start a test, 

3- IR_STATUS_FAIIED could be returned 
if the IrConnect structure was not 
bound to the stack or the packet size 
exceeds the maximum size. 


On the server side, you will receive an 
LEVENT_TEST_IND event. rxBuff and 
rxlen in /rCallBackParms contain the 
test packet. The Jr Packet structure con¬ 
tains the response packet. By default it 
will contain the same packet that was 
sent as the test. However, you can change 
the dam and that is what will be returned. 
Once the callback function returns, the 
test response w ill be sent. 

Conclusion 

This covers the IR API on the Palm HI. 
If you carefully study the IR test appli¬ 
cation, you should have little trouble un¬ 
derstanding the Battleship application, 
Td like to add a special thanks to Todd 
Warren at MCI WorldCom for his gener¬ 


ous loan of the additional hardware used 
in development. 


For More Informotion 

3Com 

5400 Bayfront Plaza 
Santa Clara, CA 95052 
408-326-5000 
http: //www, 3com. com/ 

Metrowerks Inc. 

9801 Metric Boulevard 
Austin, TX 78758 
800-377-5416 

http:/' /www, metrowerks.com/ 
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Listing One 

static void StartApplicflt£an(vaid ) 

f 

// cheek for ir 

if [SyBLibFinddrLihUanLe.&itref) 1= 

[ 

itAvail * false; 
l 

else 

t 

if (IrOpenfiiref,irQpenOptSpeedl15200) 0) 

irAvail — false; 

else 

I 

irAvail = true; 

Itflitid (irref ^connect. BSirC&lI&ank): 

IrSetDevieelnfotercef,fBytePtrJ&connect.lLGap,1}: 
IrSetCanTypeUiP^caniiect) f 


} 

] 

if (!irAvail) 

FnnAlert(HoIRAlert): 

SyaCrH t RQKTok en (0. eysRQMToken Snum, S s or ie INo. frse r ialKoLe n ) ; 
SysRandonCTimCetSecondst))E 

g,HTTie. recno = 655-35: 

game.atatted = false; 

CurrefrtView = StartupForaForai: 

CurrentMetiu - HenuIniitSlarrupMeiuiBar) ; 

FrwGotoFonii'l Current View) ; 

PpenDatabeseO; 
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Treck Real-Time 
Embedded Internet Protocols 


We know that schedules are always tight, and that you do not 
have time to "port 11 Internet protocols into your embedded envi¬ 
ronment (let alone write them from scratch). That does not 
stop marketing people inside your company from asking for In¬ 
ternet functionality in your new product line that is rolling out 
in the next few weeks. Now you have someone to turn to... 

• The FASTEST TCP/IP for Embedded Systems 

■ Fully TESTED and Qualified 

■ SMALL Code Footprint 

■ RFC2000 Compliant 

• Processor, RTOS, and Compiler Independent 

• Written from "scratch" for Embedded Systems 

• BSD4.4 Sockets Interface 

• Base TCP/IP includes TCP, UDP, ICMP, IP, ARP, 

ETHERNET, SLIP, PPP, and PING 

• Optional Products include SNMPvl, SISIMPv2,5NMPv2c, 
SNMPV3, Webserver, POP3, SMTP, PPP, BootP, DHCP, 
FTP, and Telnet 

• NO PORTING REQUIRED 


Tfeek 

(800)340-6648 or (513)688-0553 
or visit our web page at www.trcck.com 


REAL EASY 


Easy To Use, Easy to Deploy 

Imaging Components ano Technology 


RasterMaster for Java 2.0 
Imaging Class Library 


RasterMaster 7.0 
Imaging Components 

Also Avail able: 
Annotation & Redlining 
Internet Plug-Ins 
Image Viewers 


Mikmso^ 1 i| 

fF JtH YranrfliMdPBtnantrjKi^ricnCT 


TIFF 

PDF 

Group 4 

ABIC 

BMP 

DICOM 

JPEG 

CALS 

MO:DCA 

GIF 

CMYK 

JEDMICS 

EPS 

PNG 

50+ More) 


Windows 98/95/NT, Java, 
Mac, UNIX, & More 

Visit Us At 

www.§d owbnd.com 

For Free 
Demos & Evals! 

29 Crafts Street Suite 550 
Newton, MA 02458 USA 
Phone: 617-630-9495 

Fax: 617-63WJ210 

Email: salesfc^owbndcom 
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EMBEDDED SYSTEMS 


Parallel Functional 
Decision Trees for 
Situated Agent Control 


Coping with 
unpredictability 

Rene Schaad 

A “situated agent 1 ’ is a controller lo¬ 
cated in a dynamic, complex, and 
relatively unstructured environ mem. 
Situated agents can be either hard¬ 
ware or software Cor both). Software is 
almost always involved; hardware is need¬ 
ed to complete the agent if its environ¬ 
ment is physical. Hardware then plays the 
role of die interface, although it can also 
be a part of the computation itself. Typ¬ 
ical hardware-based situated agents in¬ 
clude mobile robots, autonomous un¬ 
derwater vehicles, intelligent rooms, and 
the like. 

Pure software situated agents, on the 
other hand, are located in virtual worlds, 
A software-based situated agent's envi¬ 
ronment is logical instead of physical The 
interface consists of communication in¬ 
terfaces to this logical environment —one 
that is dynamic, unpredictable, large, and 
complex Situated software agents include 
load balancing in telecom networks, and 
virtual characters in storytelling systems 
and games. 


Rene completed his Ph D. in computer sci¬ 
ence at the Artificial Intelligence Labora¬ 
tory of the University of Zurich, Switzer¬ 
land. He can he reached at schaad® 
ifi.umzhch. 


Ln general, agents attempt to achieve a 
multitude of goals by interacting w ith their 
environment via their sensors and actua¬ 
tors. The goals are often in competition 
with each other, and it is up to each agent 



to autonomously find a way to deal with 
the conflicts that ensue. This is a difficult 
task. The complex and dynamic nature of 
the environment has the effect that the 
agent; 

* Does not have complete control over 
Lhe environment, 

* Does not have the capacity to devise 
complete models of its environment. 

* Does not possess complete information 
about the environment, 

* Cannot completely trust the information 
it does have, because it is usually un¬ 
certain, imprecise, noisy, or outdated 
due to the nature of its perceptual pro¬ 
cesses. 


An agent must act coherently if it Is to 
achieve its goals; that is, its actions must 
consistently Lead toward its goal (if the 
agent is a mobile robot, for example, 
reaching a particular location in the envi¬ 
ronment), On the other hand, the agent 
must remain responsive and react appro¬ 
priately to unexpected events that occur 
in the environment (for instance, if unex¬ 
pected obstacles occur in the robot s path). 
However, iL is usually impossible to de¬ 
vise rules For conflicting goals such as 
these, without assuming perfect knowl¬ 
edge and planning. To deal with this prob¬ 
lem. designers of situated systems must 
be given tools to represent reactive rules 
as well as coherent actions in their plans 
(sequences). 

Because an agent does not usually have 
all the information it needs, it must act to 
gain information (as opposed to acting to 
reach its primary goals). 

Finally, using instructions sensibly in a 
given situation involves checking whether 
or not Lhe application of these ins true- * 
lions makes sense (guarded interpreta¬ 
tion) and in whaL way they bear upon 
the current situation (context-dependent 
interpretation). 

Due to a shift of emphasis in this field 
from building disembodied minds (chess 
players, for instance) to creating more em¬ 
bodied forms of intelligence (“elephants,” 
as described by Rodney A. Brooks in Ele¬ 
phants Don’t Play Chess,” Robotics and 
Autonomous Systems 6, 1990), these types 
of control problems have recently gained 
interest in the field of Artificial Intelligence 
(AI). The effect of this shift is that some 
areas of Al have begun to overlap aspects 
of embedded-systems programming. 
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Java code iff embedd 


Introducing the Industry’s First Highly Optimizing Cross-Compiler Suite tor the Java Language 


With the FastJ compiler suite, you get all the 
benefits of the Java programming language 
without the overhead of a Java Virtual Machine. 
Write your program in Java source code. 
Compile it. Straight to machine code. For the 
most popular 32-bit embedded processors. 
PowerPC, 68K/CPli ; 32, ColdFire, and M-CORE. 


What's more. Fast] is built on top of Diab Data’s 
industry leading optimization and code 
generation technology. With FastJ, you gel die 
fast, compact, stable code you want with the 
ability to mix C/C+ + and assembly. And with 
Diab Data’s award-winning RTA Suite, you gei 
the tools to analyze and improve program 


performance, detect run-time errors, and get 


moving to the next winning design. 


Diab A Data 


Defining Compiler Performance 

An Integrate# Systems Company 


USA: Tel: 650.S7i.l700, Fax: 650.571.9068. Europe: Tel: +49 (0)89.9593.1191, Fax: +49 (0)89.930.5184 


€> WS, Diab Data, Inc, All Rights feserved jiivj and all Java-based Ircidcmurbi and logos are trademarks or registered trademarks of Sun Microsystems, Inc. 
iti the United Suites and oilier countries. Diab Data, Hie. is independent of Sun Micro^tems, Hie Fsiscl is a trademark of Diab Daia, Inc. 


www.ddi.com infold rli.com 













(continued from page 62) 

Many areas apply and test techniques 
from situated-agent design. Probably the 
most recognized area is that of mobile 
robotics, NASA’s Sojourner Mars rover has 
arguably been the most prominent (semi- 
autonomous) situated agent in recent 
years. But there are also other more 
down-to-earth applications — network 
load balancing, intelligent rooms, intelli¬ 
gent artificial creatures for virtual reality* 
and more. 

In this article, l will present an approach 
to programming reactive situated agents 
dial is based on parallel functional deci¬ 
sion trees. In the process, I will present 
“InSitu/' a C++ class library and run-time 
system for situated agents that addresses 
the aforementioned problems and re¬ 


quirements. An alpha version of InSitu is 
available electronically; see "Resource Cen¬ 
ter,* page 5* This early version of InSitu 
is written in Watcom C++ for the QNX 4 
real-time operating system. 

In my approach to the problem of pro¬ 
gramming reactive situated agents, the first 
design decision I made was to implement 
a reactive mn-time system in C++ and then 
create C++ classes to add functionality for 
coherence, active perception, and situat¬ 
ed instruction use. The result was InSitu. 
Most environments for embedded systems 
are designed the other way around— they 
use a sequential programming language 
(such as C++) and add multithreading, in¬ 
terrupt* and event-handling mechanisms 
to achieve reactive behavior in that se¬ 
quential (coherent) framework. 


Win32 RTOS for x86 Embedded Systems 

On Time’s embedded systems RTOS implements a 
Windows NT subset kernel in only 16k of memory. 


On Time's 32-bit RTOS has a scalable com¬ 
ponent architecture. Only the components 
actually needed by the application are loaded 



RTOS Features: 

► Source and binary compatibility 
with Windows 95/98/NT/2000 

► Supports DLLs 

► Supports Borland. Microsoft, 

Watcom, Delphi Compilers 

► Unmatched real-time performance 

► Context switch 0.73^s on PI20 

► Supports (but does not require) 

PC compatible hardware 

► Boots from disk, BIOS extension, 

ROM, or DOS 

► Free tech support 

(less than 2d hours turnaround from 
developer team guaranteed) 

► Full source code available 

► Free Evaluation Kit 

available at http://www.on-time.com 

► No run-time royalties 


RTOS Components: 

RTTarget-3 2 

Core Operating System 
and Development Tools 

Price: $1700 


RTKernel-32 

Real-Time Multitasking 
Kernel lor RTTarget-32 

Price: $1950 

RTFiles-32 

FAT File System 
tor 8TTarget-32 

Price: $1700 

RTIP 

TCP/IP Stack 
for RTTarget-32 

Price: $7500 




x86 Embedded Systems at Prices that Won’t Make You WinCE 

http://www.on-time.com 

On Time/ r~ 


North America: On Tim • 08 Quinlan tame * klautat HK II7JJ - IfiA 
Phone (514) MW-6S54 * Fan (516) 6BMI72 - rnai irfc@on-limE.oim 

International: On Time - IWwg IS - 2TOS5 fcmthuri? ■ Germany 
Phtme +4M0-227HQ5 ■ Tax +4MS-22?«4J - eroi mfo@Dn.time.de 


REAL-TIME AND SYSTEM SOFTWARE 


InSitu was developed and tested on a 
mobile robot called Rufus T. Firefly (see 
Figure 1 and http://www.ifi.unizh.ch/ailab/ 
projeas/mlus/) that was tasked to patrol 
a floor in an office building and report hu¬ 
man intruders back to a base station via a 
radio link, I have found InSitu to be a mod¬ 
ular, efficient, and robust tool lor the de¬ 
velopment of control laws for this type of 
situated agent. The decision tree-based ar¬ 
chitecture is particularly well suited for the 
incremental and fast development of 
situation-dependent control rules. 

Stepped Execution 

A run-time system for reactive situated 
agents (or any embedded system) may be 
implemented according to one of two 
types of execution models. The system ei¬ 
ther uses interrupts to produce events, 
which then steer event loops, finite state 
machines, and other such constructs to 
control the agent; or the system may reg¬ 
ularly poll its sensors, categorize the sensed 
situation, and produce outputs accord¬ 
ingly. Mainly for efficiency reasons, most 
systems use an event-driven approach. 
However, in the A1 arena, situated agents 
arc most often based on polling. The AI 
community has adopted the rather gen¬ 
eral term "reactive systems" for these types 
of polling-based situated agents so that 
they can be distinguished from tradition¬ 
al Al planning Lind control systems that 
emphasize coherence over reactivity and 
are often rather unresponsive. 

Control following the polling-based ex¬ 
ecution model, which I will call the 



Figure 1: Rufus T. Firefly. 





















"stepped execution models proceeds in 
a loop with three steps: 

1. Based on sensor readings, a simple in¬ 
ternal model of the environment is up¬ 
dated, 

2. 'Hie state of this model is categorized 

into one of a number of situations. A 

situation is a set of states, 

3 The situation is mapped to some actu¬ 
ator output, and die loop recommences. 

It is important that the types of model¬ 
ings and mappings that are employed in 
this loop be limited to those that can be 
computed incrementally during the time 
of one loop, and that outputs are pro¬ 
duced at each incremental step. Long or 
unpredictable computation times must be 
avoided. Algorithms based on lookup ta¬ 
bles, neural networks, fuzzy logic, or de¬ 
cision trees are Ideal candidates for this 
type of computation. 

At first glance, polling seems to be a 
bad choice. Event-driven control is usu¬ 
ally more efficient because computations 
are carried out only when important events 
happen. In addition, by employing mul¬ 
titasking, other tasks can be tended to if 
no events are being processed, thereby 
taking full advantage of each processor 
cycle. Event-driven control is also more 
convenient to program because it is usu¬ 
ally not necessary to divide the computa¬ 
tion into short incremental steps. When 
an event occurs, all the computation as¬ 
sociated with that step is carried out at 
once; long running processes are auto¬ 
matically sliced by the multitasking mech¬ 
anism. 

However, polling has a critical advan¬ 
tage, Interesting events in the environ¬ 
ment cannot always be assumed to be 
producing events because, as Eve out¬ 
lined earlier, a situated agent does not 
have continuous access to all the impor¬ 
tant information. Hence, it is not sufficient 
for the agent to passively react to events 
and create outputs only in response to 
these events. It must pursue the acquisi¬ 
tion of information. Furthermore, it must 
produce actuator commands at regular in¬ 
tervals even if nothing interesting has hap¬ 
pened. Event-driven execution is okay for 
passive reactive systems that have con¬ 
stant access to all relevant information, 
but polling Is necessary for systems that 
must initiate action or deal with incom¬ 
plete information. 

An execution system lor this model can 
seem almost trivial. It consists of a loop 
with a call to the input (sensors to input 
buffers), mapping (input to output buffers), 
and output functions (output buffers to ac¬ 
tuators), with a delay statement All the in¬ 
teresting computations take place in the 
mapping function. 


Steppables 

The most important abstraction in InSi- 
Lu is “Steppables"— objects that encap¬ 
sulate mapping algorithms executed in 
a step-wise fashion, but produce coher¬ 
ent sequential behavior over the course 
of many steps. Thus, Steppables are de¬ 
signed to address the coherence-reac¬ 
tivity problem. According to Erich Gam¬ 
ma et al, in Design Patterns; Elements of 
Reusable Object-Oriented Software (Ad¬ 
dison-Wes ley, 1995), encapsulating al¬ 
gorithms in objects follows a design pat¬ 
tern called "Strategy” and serves to make 
different algorithms compatible and in¬ 
terchangeable. Steppables are imple¬ 
mented as classes derived from the ab¬ 
stract class Steppable, wliich defines their 
basic interface. This interface consists of 


the Step, Reset , Abort, and IsDone mem¬ 
ber functions; 

Data *Step(void) ; 

void Abort (void) ; 

void Reset(void); 

Fuzz *IsDone(void): 

The Step member function advances the 
algorithm by one step, produces side-ef¬ 
fects to other Steppables and returns a re¬ 
sult to the caller. Reset and Abort set the al- 
goritl irris progress to its lieginning and end, 
respectively. IsDone returns a fuzzy Btxdean 
value, indicating the algorithm’s status (ei¬ 
ther it has not yet started, it is in progress, 
or it has terminated), A stepped algorithm 
may take an arbitrary number of calls to 
the Step member function for its comple¬ 
tion. Thus, Steppables offer support for 


Introducing The Easiest Way To 
Connect Peripherals ANYWHERE. 

RocketPort™ Serial Hub 


m m mm 


Now you con connect your peripherals to your PQS system horn anywhere 
your networkusing the Rocket Pott Serial Hub . Your server 
could even reside in the building next door! 

The RocketPort Serial Hub is a 4- or 8-port serial expansion device for 
Intel-hosed computers, providing 1 native" COM ports that 
deliver beyond the limits of in-server cards . 

Ethernet-attached solution providing 4 or 8 "native" COM ports 

♦ 

Quick and easy-just install the driver, it does the rest 

♦ 

Connects to your existing network or a dedicated NIC card 

♦ 

Works with a back-up server hr huh tolerance and enhanced reliability 
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combining reactive and coherent aspects 
of execution by uniting the stepped ex¬ 
ecution model with the abstraction of se¬ 
quential algorithms. 

As an example, consider Timed If, a 
Stoppable from the InSit u class library: 

Steppable *a = new Timedlf 

(St ep pable * c on d, 
Steppable *then, 
Steppable *else» 
int stick^delay): 

Timedlf is a class derived from Step¬ 
pable, Its purpose is to encapsulate the 
following behavior: On each time step 
(that is, on each call of the run-time sys¬ 
tem to Timedlf T s Step member function), 
Timedlf calls the Step member function 
of the Steppable pointed to by the con¬ 


structor's argument cond. If that call re¬ 
turns a Data object of type Fuzz (a kind 
of fuzzy Boolean value), and if that re¬ 
turn value evaluates to a true statement, 
the Step Function of the Steppable point¬ 
ed to by then is executed. Otherwise, the 
Step function of else is executed. In addi¬ 
tion, after a successful execution of cond s 
Step function, a countdown timer is initi¬ 
ated to stick_delay milliseconds. While 
this timer is running, then's (rather than 
else “s) Step function continues to lie ex¬ 
ecuted on each consecutive time step. 
Hence, Timedlf implements a kind of de- 
bounced if statement, 

Timedlf is an example of a Steppable 
intended to produce actions by calling an¬ 
other Steppabit’s Step functions. These 
types of Step pa hies are called “Action- 


Steppables* and are derived from die ab¬ 
stract class Action, which is itself derived 
from Steppable, Aside from Action- 
Steppa hies, there are also Data-Step pa hies, 
intended to passively store data. To this 
end, each Data'Steppable has a Step mem¬ 
ber function that does nothing more than 
return a pointer to itself. Abort and Reset 
are degenerated functions that do noth¬ 
ing, and hDone always returns a point¬ 
er to a Fuzz object* which evaluates to 
True, Tn addition to the standard inter¬ 
face, Data-Steppables add functions for 
duplication, printing, accessing instance 
variables, and managing run-time type 
information, Data-Steppables may be 
passed around between Action-Steppables 
as results or parameters. They may be 
used in place of Action-Steppables (be¬ 
cause their interfaces are compatible), and 
they may be used from die InSitu Script 
(ISS) online instruction compiler. 

Programming in the stepped-execution 
model can be tedious, Steppables are in¬ 
tended to make this task easier by pro¬ 
viding a uniform framework, a run-time 
system, a uniform set of interface func¬ 
tions, and a library of premade compo¬ 
nents for developing, assembling, and 
running such stepped programs. Fur¬ 
thermore, Steppables can be dynamical¬ 
ly allocated, deleted, inserted, and re¬ 
moved from a running program, InSitu 
uses this feature to allow the ISS compil¬ 
er to add and remove parts of a program 
at run time. Finally, using objects to en¬ 
capsulate algorithms allows multiple 
copies of the algorithms with different lo¬ 
cal states (lor example, multiple copies 
of Timedlf with different values of the 
countdown timer). These are the advan¬ 
tages of implementing stepped algorithms 
as objects instead of plain functions. 

Parallel Functional Decision Trees 

The constructors of Steppables accept 
pointers to other Steppables as arguments. 
These pointers are kept in instance vari¬ 
ables and are used by the objects’ mem¬ 
ber functions (Step, Abort , Reset, and Zs- 
Done) throughout tbeir lifetimes to access 
the referenced objects' memter functions. 
In this way, nested structures of Steppables 
referencing other Steppables can be con¬ 
structed at run time by allocating and 
cross-1 i n king objects. 

In essence, assemblages of linked Step¬ 
pables implement a kind of decision tree. 
Indeed, each Steppable itself can be 
thought of as implementing a part of a de¬ 
cision tree, called a “decision subtree." !n 
this analogy, die root of a subtree imple¬ 
mented in a Steppable is represented by 
the call to its Step member function. The 
leaves of the subtree, which are at tile same 
time the roots of connecting subtrees, cor¬ 
respond to the exits of the Steppable, An 
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exit of a Steppable is a pointer to another 
Steppable that is passed to its constructor, 
In other words, the exits of a Steppable arc 
those arguments in its constructor that arc 
pointers to other Steppables. 

But Steppables are not pure decision 
trees. They are enhanced in several ways. 
Their first enhancement concerns their de¬ 
cision functions—the functions in the 
nodes of the decision tree that select one 
of the brandies for traversal In simple bi¬ 
nary decision trees, this function is a 
Boolean expression, such as door == 
open. Depending on the outcome of this 
expression (True or False), one of the 
branches emerging from that node is tra¬ 
versed, and execution continues at the 
node at the end of that branch. 

However, the problem with this ap¬ 
proach in situated agents is that it is gen¬ 
erally not known whether the decision 
function (door == open) evaluates to True 
or False, as the agent will simply not have 
sufficient information to answer this ques¬ 
tion. Thus, it is necessary to allow the agent 
to answer the question by interacting with 
the environment (active perception). Since 
Steppables control interaction with the en¬ 
vironment, the decision function itself must 
be implemented as a decision subtree con¬ 
sisting of Steppables. From this, several re¬ 
quirements for cite so-called parallel func¬ 
tional decision trees follow: 

* Decision functions as decision trees. De¬ 
cision functions must be implemented 
as decision trees as well Consequent¬ 
ly, there will be no conceptual distinc¬ 
tion between branches that serve to 
compute a decision function, and 
branches that primarily serve to perform 
actions. Only their roles differ. In par¬ 
ticular, both types of decision subtrees 
may read sensors and perform actions. 

* Functional extension. Decision trees 
must be able to return data to the callers 
of their Step functions to serve as deci¬ 
sion functions. We will later see that die 
capability to return data is also used for 
other types of active perception. 

* Parallel extension. Decision trees must lie 
able to traverse several paths on each time 
tick; for example, the path of a decision 
function, and the path of the branch se¬ 
lected by the result of die decision func¬ 
tion must be traversed in die same step. 
Even though they are executed sequen¬ 
tially within the time tick, conceptually 
they are executed in parallel 

All of diese requirements are met by Step¬ 
pables, which, in effect, implement sub¬ 
trees of parallel functional decision trees. 

Example 1. a simple reactive program 
implemented as a collection of decision 
trees, is a fragment of a C++ program that 
allocates five objects which are all derived 


from the abstract class Steppable: Sticky!/, 
BumpedQ, Prog, Movehy , and Titrnhy. it 
is a simple solution to the problem of get¬ 
ting a mobile robot around an obstacle. 
The program basically says: If you get 
burned against an obstacle, perform die 
following steps to completion: Move the 
robot backwards by 0.1 meter, and then 
turn the robot by 90 degrees to die left. 
After this, or if ihe robot is not bumped 
against an obstacle, continue with the de¬ 
cision tree pointed to by do_tbe_other_$tiiff 
as a control program, The_rolx>i Is a point¬ 
er to a plant proxy'; dial is, an object rep¬ 
resenting the controlled robot diat han¬ 
dles all input and output. The plant proxy 
is also derived from Steppable, 

After the assignment, unhump is a 
pointer to a parallel functional decision 


tree consisting of a number of objects de¬ 
rived from Steppable, which can be 
stepped to execute the desired actions. 


Steppable ^unburnp - 
new Stickylft 

new BumpedQ (the _ robot] , 
new Prog,( 

NULL, 

new 

Moveby(the.robot. ^0.1). 
new 

Turnhy(the_robot, PI/2) 

)> 

do.the.other .stuff 

); 


Example 1; Simple reactive program 
implemented as a collection of 
decision trees. 
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This is usually done by passing unbump to 
the run-tune system, which then inserts it 
into a Larger decision tree in a suitable spot. 

Remember thaL even though this frag¬ 
ment looks sequential and each Stoppable 
controls a sequential process, it is exe¬ 
cuted in a purely reactive, step-wise man¬ 
ner. The Steppables serve to reintrcxluce 
sequentiality and coherence into a basi¬ 
cally reactive scheme. To this end, they 
store the local sequential state that sur¬ 
vives calls to their Step functions; that is, 
the Prog class (a member of the InSitu 
standard class library) is designed to ex¬ 
ecute its exits in sequence. This means 
that when Prog is stepped, it propagates 
the call to one of its exits. Each exit keeps 
being stepped until its IsDone methods 
returns True, indicating its completion, 


at which time the program counter in 
Prog is incremented to the next exit. Af¬ 
ter stepping all exits (in the example a 
Movehy > and a Turnhy object), the default 
exit (in the aforementioned example set 
to NULL) is stepped until a call to Prog's 
Reset function restarts the sequential pro¬ 
cess. Similar classes exist in LnSitifs class 
library for loops, sequences with condi¬ 
tional increments, finite state machines, 
and many other temporally coherent 
types of behaviors. 

Classification of Situations 

Decision trees classify data. When deci¬ 
sion trees are used to control an agent, 
their purpose is to classify die state of the 
world as they encounter it and assign pro¬ 
grammed actions to this class of world 
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states, m call classes of world states “situ¬ 
ations.” With decision trees, this classifica¬ 
tion is recursive; that is, each branch in the 
decision tree acids accuracy to the classifi¬ 
cation, and the number of states in the re¬ 
sulting situation decreases with each 
branch. Each node in the decision tree thus 
corresponds to a particular situation in the 
world. By attaching a decision subtree to 
a particular node in the tree, you tell the 
system that this subtree implements a good 
strategy for this particular situation. Hence, 
when an agent stops being used, and an¬ 
other more appropriate one is used. 

Another way of looking at Steppables 
is dial they allow you to provide a pre¬ 
fabricated system decision tree, called a 
“default tree,” where a situated agent de¬ 
fines a default classification, and thus a 
default behavior. You may then incre¬ 
mentally add decision trees to handle cer¬ 
tain situations differently, or add new dis¬ 
tinctions to handle subsituations in 
different ways. This possibility of incre¬ 
mentally adding modular handlers for sit¬ 
uations is a powerful tool for building re¬ 
liable situated agents. 

InSitu Script 

With InSitu, it is even possible to add 
such handlers (also known as “decision 
trees” or “clusters of Steppables”) during 
the run time of the system. The InSitu 
Script (ISS) compiler is an object within 
the InSitu run-time system that accepts 
commands from an online user during 
run time via a number of input channels 
(for instance, a wireless radio link on a 
mobile robot), ISS’s syntax is based on 
LISP, But in addition to pure LISP func¬ 
tions, InSitu also provides a mechanism 
called “factory functions.* Factory func¬ 
tions allocate new Steppables inside the 
InSitu system. Other system functions al¬ 
low you to add or remove these allocat¬ 
ed Steppables to and from the running 
system; see Example 2. 

The first nested call to the LISP func¬ 
tions creates a nested cluster of Step¬ 
pables* Each of these LISP functions (ex¬ 
cept for setq) is a factory function that 
creates an object of the corresponding 


(setq y 

(Sticky If 

(BumpedQ) 

(Prog 

(Noop) 

(Hoveby -0.1) 
Crumby 1.7) 

> 

[Noop))) 

(Do y "some location") 
(Stop y) 


Example 2: Adding and removing 
allocated Steppables to and from the 
running system. 
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(continued from page 68) 
type and returns a reference to that ob¬ 
ject The resulting reference is stored in 
the LISP variable y. The function calls 
(Do y tf some location”) and (Stop y) in¬ 
sert and remove the new subtree into and 
from the default decision tree at a loca¬ 
tion designated with a so-called “Dock- 
Steppable," which bears the name "some 
location," respectively. Dock-Steppables 
are specifically designed to serve as 
named location for subtree insertion. All 
Docks in a system are managed by a 
Dock manager object. 

In this way, a running system may be 
changed and its dynamic behavior debugged 
by observing its actual interaction with the 
real world. ISS can also lie regarded as a 
high-level command Language for real-Lane 
man-machine communication. 

Active Perception 

Decision subtrees are able to return data 
to their callers (functional extensions). 
This facility was introduced to allow de¬ 
cision functions to acquire information 
through action (that is, through active 
perception) and use this information to 
select branches in decision trees. This 
type of active perception is often said to 
be about achieving knowledge goals. It 
is the goal of the agent to gather knowl¬ 


edge. But there is also another type of 
active perception that is supported by 
this mechanism — symbol registration, 
lnSitu uses objects called "Markers" (a 
type of Data- Steppable) as references 
to objects in the real world. For instance, 
an object storing the coordinates of a 
dog in the camera image of a mobile 
robot might be such a Marker. Markers 
must be registered and tracked—their 
initial and changing values must be de¬ 
termined. Both registration and tracking 
may involve actions; for instance, it might 
be necessary to pan the robot's camera, 
turn its base, or move forward to keep 
the dog in its field of view . InSitu has 
Steppables to support both registration 
and tracking. 

The programs to implement such reg¬ 
istering and tracking behavior are, of 
course, also implemented as Steppables, 
and the results (the markers) are com¬ 
municated to their callers as return values 
of their Step member functions. 

Conclusion 

A number of ideas for extending or mod¬ 
ifying this scheme, however, have come 
up as well For example, decision trees 
are an ideal basis for a development en¬ 
vironment based on visual programming. 
But to support visual programming, Lhe 


representation of the decision tree struc¬ 
ture should be separated from Lhe SLep- 
pables responsible for the executable 
code. Currently, the representation of the 
decision tree structure, the traversal algo¬ 
rithm for the decision tree, and the rep¬ 
resentation of die executable code are all 
the responsibility of the Steppables. To 
have lietter access to these data structures, 
visual programming would require the 
separation of these responsibilities. Fur¬ 
thermore, ideas are in the pipeline tor lan¬ 
guages based on the aforementioned 
ideas, for the integration of planning al¬ 
gorithms (automatic program generation), 
and for natural language interfaces based 
on the types of active perception report¬ 
ed here. 

Parallel functional decision trees as im¬ 
plemented by InSitu are a simple yet 
powerful way to program reactive situ¬ 
ated agents. It tackles problems of the 
coherence-reactivity trade-off and of ac¬ 
tive perception in a pragmatic way, and 
offers a modular and efficient program¬ 
ming paradigm. 
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L DAP (short For “Lightweight Directo¬ 
ry Access Protocol") promises to be 
a central repository of information 
about users and corporate resources. 
However, if it is difficult to access or 
manipulate that information, then few r 
organizations will take LDAP seriously. 
Programmers and administrators, in par¬ 
ticular, need to be able to access this in¬ 
formation through a variety of methods 
and tools. 

From a programmer's perspective there 
should be several ways to access the in¬ 
formation. A low-level C API for directo¬ 
ry access, for Lhose times when speed is 
important, needs to be embedded in a 
compiled application. Java is becoming 
more important in die corporate environ¬ 
ment, and as a result access to LDAP from 
Java has become a necessity. Rut there 
are also times when the ability Lo gener¬ 
ate a quick prototype in a scripting lan¬ 
guage can make the difference in a pro¬ 
jects success. 

Administrators also need several ways 
to get to the information in a directory. 
A GUI for adding and changing informa¬ 
tion easily is an absolute requirement. 
Command-line utilities are frequently im¬ 
portant for doing batch updates. Howev¬ 
er, sometimes command-line utilities don't 
allow a fine enough degree of control, so 
once again access through a scripting lan¬ 
guage is important. 


Troy is a systems engineer for Intraware 
and can he contacted at troy@ 
intraware.com. 


To address issues such as these, Netscape 
has released PerLDAP, which provides a 
mechanism For accessing directory infor¬ 
mation from Perl. This Ls an important toed 
for Ixith programmers and administrators. 
In tills article, HI provide both a high-level 
overview of what PerLDAP does a nd a de¬ 
tailed explanation of how you can use it. 

What is PerLDAP? 


PerLDAP (available in source code form 
at http://www.mozi 1 la.org/directory/ 
perldap.html) is a set of Perl functions 



and objects that simplify access to LDAP 
services. Although Netscape released 
PerLDAP with the intent that it be used 
with the Netscape Directory Server, it 
should work equally well with most LDAP 
v3 - comp! i a n L dtrectori es. 

Netscape now r has three ways for you 
to access LDAP. The first of these is the C 
API, which is distributed in the form of 
the Directory Server SDK. This SDK is 
available for a w ide variety of platforms, 
and would be used by anyone develop¬ 
ing an LDAP application in either C or 
C++. For Java developers, Netscape has 
the Java LDAP SDK. As you'd expect, the 
Java SDK has an object-oriented approach, 


and as such is much easier to use than 
the C API PerLDAP also has an object- 
oriented approach to LDAP. PerLDAP is 
the most approachable of these three tods 
for accessing die Directory Server, All three 
tools (and some others as well) are avail¬ 
able at Netscape's DevEdge Online (http:// 
developer, net sea pe.com/program/ 
bo me Jit ml), 

Experienced Perl developers may already 
lx? familiar with the Net::LDAP- api pack¬ 
age available on the CPAN, the Compre¬ 
hensive Deri Archive Network (httpd/wwvv 
.cpan.org/)* NetTDAPapi does have a Perl 
object-oriented interface, but does not pro¬ 
vide a general- purpose LDAP object In oth¬ 
er words, NetaLDAPapi really only gives 
you access to the LDAP API without pro¬ 
viding a simpler-to-use object-oriented 
mechanism. PerLDAP, on the other hand, 
gives you a more general-purpose LDAP 
object dial behaves much like the Java LDAP 
classes, which are part of the Java LDAP 
SDK 3.0. Both PerLDAP and NetaLDAPapi 
require the Directory .Server SDK 3.0. 

PerLDAP comes witli a set of Perl func¬ 
tions that mirror the functions in the Direc¬ 
tory Server SDK. These functions let you 
connect to a Directory Server, create, mod¬ 
ify, and delete LDAP entries. More impor¬ 
tantly, PerLDAP includes two objects diat 
wrap around these functions, creating a 
more friendly developer experience. These 
objects are Mozitla::LDAP:.Conn and 
Mozilta:: LDAPwEn try. 

Mozilla::LDAP::Conn is a general- 
purpose LDAP object that is instantiated 
by calling the new() method with the ap¬ 
propriate parameters. The parameters are 
the host name of the directory server, the 
hind distinguished name (dnL the bind 
password, and the LDAP search base. 
Once a connection has l^een established, 
Mozitla.:LDAP:-Conn has methods for 
sea idling the directory server, adding en¬ 
tries, modifying entries, and deleting entries. 

Mozilla::LDAP;.Entry is an object that 
gives you access to the components of an 
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(continued from page 72) 

LDAP entry', ft also provides methods for 
modifying an entry. Many MoziUa: dJDAP:; 
Conn methods return Mozilki\'LDAP::ErUr} f 
objects. 

Because most LDAP entries are in tex¬ 
tual format, Perl’s strong string-process¬ 
ing capabilities make it a natural hi. Fur¬ 
thermore, the ease of using the PerLDAP 
objects can make it an attractive alterna¬ 
tive to using die command-line tools such 
as Idapsearch and Idapmodify. PerLDAP 
gives you the ability to create an LDIF ex¬ 
port without shutting down the Directo¬ 
ry Server. It includes sample code for syn¬ 
chronization with PeopleSoft* It can also 
be used to batch import users from oth¬ 
er user databases. Only need and imagi¬ 
nation limit the list of possible uses. 

An Example Application 

It is common for an organization to set 
up a variety of mailing lists. The uses range 
from loeing an alias for an entire department 
to being a tool for collaboration, If you've 
ever seen an e-mail address such as “engi- 
neering“newengland@company.com, ” then 
you’ve seen mailing lists in action. Col¬ 
laborative mailing lists frequently allow 
people to subscribe and unsubscribe to 
the mailing list on their own without the 
intervention of an administrator. This is 
usually done using a list sender such as 
Majordomo. 

The Netscape Messaging Serv er sup¬ 
ports mailing lists, but doesn't provide a 
means for users to subscribe or unsub¬ 
scribe to those mailing lists. It requites that 
administrators manually add users to 
groups. This generally encourages people 
to look to an external program such as 
Majordomo to manage their mailing lists. 

The example ! present here, which 
demonstrates the inner workings of 
PerLDAP, is a CGI program that can be 
used to manage mailing lists via Direc¬ 
tory and Messaging Servers, 1 will demon¬ 
strate some techniques for connecting (or 
binding) to the Directory Server, pro¬ 
cessing the results of a search, and mod¬ 
ifying LDAP entries. 

Binding to the Directory Server 
Using PerLDAP 

The demo CGI program needs to do a lew 
basic things, such as prompt users to log 
in, display a list of mailing groups avail¬ 
able on die server, and let users modify 
membership in those mailing groups. List¬ 
ing One Is die core of this program. In a 
nutshell, it checks the state of the appli¬ 
cation and sends back the appropriate 
screen. The basic approach that I’ve tak¬ 
en with this CGI program is to separate 
the functions that display HTML from those 
that process LDAP entries. This is a good 
CGI programming practice, and it also 



makes it easier to focus die discussion on 
functions that make use of PerLDAP. 

Since users are going to be modifying 
LDAP entries, tt is necessary to make them 
bind to the Directory Server, However, 
users should be able to simply type in their 
user ID and password without having to 
remember their entire distinguished name. 
Users are used to this sort of behavior, and 
you want to mimic it. It turns out that this 
Is actually pretty' easy to accomplish. 

There are diree steps to binding to die 
Directory Server starting with just a user 
ID, The first step is to bind anonymous¬ 
ly to the Directory Server. The second step 
is to search for the distinguished name for 
that user ID* Listing Two shows the 
ldap_get_user_info() function that does 
these first two steps. This function also re¬ 
turns die full name of the user, but this is 
only for display purposes and not a nec¬ 
essary component to binding to the Di¬ 
rectory' Server. The third step is to use 
the distinguished name returned by 
Idap_get_userJnfo() to bind to die Direc¬ 
tory Server. This is a common approach to 
solving this problem. In fact, die Netscape 
Enterprise Server uses a similar mechanism 
for logging into the web server using just a 
user ID and password. 

The kkipj^elj tserjnfi) ) function shows 
die basics of using the Mozilla:LDAF::Conn 
package. Gil ling the nmiO method with¬ 
out specifying a bind dn creates an anony¬ 
mous connection to the Directory Serv er, 
Once a connection has lieen established, a 
search can be conducted. The search/) 
method is similar to using the LDAP 
search feature in Communicator or in the 
command-line tools* You simply specify 
a search base and an attribute to seardi 
on. The sub parameter tells the scare bf) 
method to look in subtrees. From there, 
it's just a matter of processing tile result 
set that searcbf) returned. 

The scareh() function returns a MoziUa 
::LDAP;:Entry’ if the search was successful. 
You can then use the MoziUa:: LDAP: :En tty 
methods to access the data in the entry . 
One such method is gtiDN( \ which returns 
the distinguished name of that entry. An¬ 
other useful method Ls exists! X which lets 
you check if a value exists lor the specified 
attribute. 

Extracting the values of attributes am be 
a little tricky. The most important thing to 
remember is that an entry can have more 
than one value for each attribute* In fact, 
it is quite common. For example, a typical 
entry' for an individual will have the values 
"top," “person, 11 “organizationalperson,” and 
" in etorg person" for the object class at¬ 
tribute. This is important because when 
you ask MoziUa::LDAP; Entry for the val¬ 
ue of an attribute, it will return a refer¬ 
ence to an array. The general syntax looks 
something like: 
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Svaltie = $ entry-> I atlribuielfajrayJndex]; 

You can use the sizsef ) method to deter¬ 
mine how many elements are in the array. 
For the purposes of idap_get_a$er_info( X 
you know that there is generally only one 
common name per entry, so you just grab 
the first one after testing to make sure a val¬ 
ue exists. 

Since most searches will return more dian 
one entry, a method is needed to iterate 
through line result set. That method is next- 
EntryO, which is a MoziUa::LDAP::Conn 
method In die case of kkip_j^tjLser_info( X 
getting more tlian one entry hack indicates 
there Ls a problem with the directory infor¬ 
mation tree because Netscape requires that 
uids be unique for the entire directory. 'The 
last tiling that needs to be done with any 
basic LDAP connection Ls to dose it. To do 
this, simply call closef). 

Processing Search Results 

Once you know the hind dn of the user 
in question, you can bind lo the Directo¬ 
ry Server as that user and search for a list 
of available mailing lists. Listing Three 
shows the ldap_get_nmii_groups() func¬ 
tion, which does exactly that. This func¬ 
tion is a straightforward LDAP search. The 
primary differences between this function 
and ldap_get_user_info() are Lhat you 
aren’t binding anonymously and the Func¬ 
tion populates an array with LDAP entries 
hat are the results of the search. After call¬ 
ing id£ip_get_mail_groups{ X you have an 
array full of MoziUa.:LDAP::Entry objects. 

Listing Four shows what you can do 
with that array, although this is not the 
only way to process he results of a search. 
Bather than stuffing each entry into an ar¬ 
ray, he ldap_get_jnail_group$() function 
could have processed each entry as it was 
retrieved. However, I wanted to be able 
to reuse my primary search so I separat¬ 
ed it into an another function. 

Listing Four demonstrates how to look 
through each entry to see if the user is a 
member of that group. The group lists 
members by using he uniqueMemher at¬ 
tribute, In other words, to find a user in 
a group, you have to step through he ar¬ 
ray of uniqueMemher attributes looking 
for the member, 'this is done by finding 
out how many elements are in the array 
using the sizef) method. Once this is 
known, it's simply a matter of using a for 
loop to look at each entry. You exit the 
for loop when you find the member. 

Modifying Entries 

The last major piece of functionality in 
PerLDAP that I’ll examine is how to mod- 
ify an entry, specifically how to add or 
remove an attribute and its correspond¬ 
ing value. The process is similar for both 
actions, so Hi take a look at adding an 
attribute. Listing Five shows how to do 
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this. First, connect to the LDAP server. 
Second, find die entry that you want to 
modify. Third, add the attribute value. 
This is done with the addValue() method 
of the Maxilla::LDAP::Entty object Finally, 
update die entry on the server. The updatet ) 
method of the MozUkk:LDAP:: Conn object 
has a single parameter, which is die Entry 
that has been modified. This is an impor¬ 
tant step. If update) isn't called, then the 
Entry is only modified in memory and not 
on the server. 

Making the Mailing List Manager 

If you've spent any time poking around 
the access control mechanism for the Di¬ 
rectory Server, you may have noticed a 
permission called “sdfwriteT Don’t be 
surprised if Netscape renames this per¬ 


mission in a future release because it 
doesn't do what yoifd expect. The fust 
thing thaL comes to mind is that setting 
this permission for a group of users 
would allow them to modify their own 
entry, Flowever, what it really does is al¬ 
low users to add or remove themselves 
from a groupofuniquenames , which is 
also a mailGroup. 

If you are using the Netscape Messag¬ 
ing Server in conjunction with the Direc¬ 
tory Server, die installer for the Messag¬ 
ing Server extends the default schema to 
support the use of groups as mailing lists. 
In other words, if a group is given an e- 
mail address, then the Messaging Server 
will send an e-mail addressed to all mem¬ 
bers of the group. A typical use of this 
functionality would be to create e-mail 


aliases for departments or teams. The seif- 
write permission allows users to modify 
their membership in the group, 

With a little creativity, this feature can 
also be used to mimic some of the func¬ 
tionality of a list server such as Major- 
domo. An important feature of Major- 
domo lets users self-admin is ter their 
membership in mailing groups by using 
commands sent by e-mail. PerLDAP 
makes it easy to create a web-based self¬ 
administration tool. Listing One shows the 
basic framework of such an application. 
The process Jogint) function makes use 
of binding to the Directory Server, search¬ 
ing, and processing the result set. The 
process_submit() function also adds or 
removes attributes from Entries. These 
functions both call functions that display 
HTML as well. The complete source code 
is available electronically from DDJ (see 
“Resource Center/ 5 page 5) or by writing 
me at troy@intraware.com. 

You must grant the selfwrite privilege 
to at least some groups and users for the 
Mailing Group administration CGI to work. 
Refer to the Directory Server Administra¬ 
tor's Guide tf you need help in setting up 
access control on the Directory Server. Be 
sure to look al the comments at the be¬ 
ginning of the source code because they 
will tell you what all the necessary com¬ 
ponents are and how to point the pro¬ 
gram at your Directory Server, 

There are a couple of oilier tilings about 
tills program you should lie aware of. The 
first is Lhat the program passes the user’s 
password as a parameter and as a hidden 
field. This means that if you Lise it in an 
extranet environment you should be sure 
to use SSL so that this information is en¬ 
crypted, Second, you don't want to tread 
lightly in the area of access control. If you 
are working with a production Directory 
Server, he sure to coordinate all activities 
with the primary administrator because it 
is easy to lock everyone out. 

Conclusion 

fve presented just one possible use for PerL¬ 
DAP. There are many ways this tool can be 
used to simplify Directory Server adminis¬ 
tration. Tiie key tilings to remember about 
doing a search with PerLDAP are; 

• Sec up the connection using new(X 

• Make the search using searchf). 

• Process die results. 

• Close die connection. 

There are, of course, many variations 
on this theme, but if you keep these four 
steps in mind it should be relatively easy 
for even beginning Perl developers to 
make good use of this tool. 

DDJ 
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Listing One 

unles s (5cgi->param()) t 
htrol_disp.lay_loginO; 

] elflif ($agi-^param("exit 11 ) eq "Exit"} [ 
html.di£ play.login {); 

3 eleif (Scgi-^parsmCmode") eq "login 11 3 [ 

p-rDCeHS _ 1 Dg±El (J ; 

] sis if (5dgI-> par amt "mode 111 ) aq "submit") l 
procesp subrait 0; 


Listing Two 

sub ldip.get.iiser.infci [ 

my ^UBEr = $_ [0]; # The user ID 
my $bincLdn: 
my $cn: 

my $anon_i:cinn = new Hqzilla: :LDAP:: Canu($ldap_hoat, 

Sldflp.port, " M ) ! I die "Can't connect to Sldap.hoat„\n"; 

my $entry = 5Bnon_com->seHrch($S'earclh_bsBe, "sub". "{uld=Sussr3”J; 

If (I Sentry) [ 
return; 

} else t 

my Si - CJ; 
while(Sentry) E 
$i*+i 

Sbind_dn - $antEy->gatDN£j ; 
if ($entry-i>exifitfl( H cn"')) [ 

$cn = $entry->{ n| cTi 1t ) [0j : 

3 else { 
return; 

3 

B entry - S amm.ctmn- >nex±Ent ry (} i 

if (Si > 13 E 

return; 

) 

J 

$aJiDti_eDtiti->cloSe() l 

return ($bind_dn< Sen); 


Listing Three 

sub ldap get. mail atoops t 

my Sbind.dn = ?_[0]; £ The user's bind DN 

my SpaaBword -§_[!]: t The user'a password 
ny Sagref = $_[2]; ¥ A reference to an array of Entry objects 

my $conn = new Koiilla;:LDAf:;Conn(Sidap_host. $ldap.port. Sbind_dn, 
Spaaffword- i 

ny Sentry; 
my Sen; 

if ft $etmm) t 

biml display., error! "Couldn't connect to the directory server."); 
exit(0); 

) else ( 


Sentry = Scomi-isearth(Ssearth.base. "Bub", '*nb;feetc.laE3=nLBilDr0up n ) ; 
if ([ Sentry) E 

btml_display.error("There aren't any mailing lists on this 

server."); 

exit(03; 

) 

while(Sentry) { 

Sen - Sentry-H n cn"J [0] ; 

ll add the entry to the array unless it's the Postmaster group 
if (Sen na "Postmaster") [ 
push(®Smgref.Sentry); 

Sentry = Seonn-JnextEntryf) t 

$conn-^cloee(); 

) 

) 

Listing Four 

fotasch {SmailGroup) { 

Sgroupffame = $.->E"cn"3 [01; 

$deacription = S_->["description"3L&I: 
iny SisWember = 0‘ 

my Set = $_->si 2 e ["Liniquemembcr"); 
for ($i = 0: $i < Set : $i++] £ 

if ($bind_dn eq $_->f"uniquemenber"}[$i]3 C 
SieMcmbet = lj 
last: 

] 

) 

html_row(SisWember, SgroupName r $et, SdescriptlonJ; 


Listing Five 

sub 1dap_add_to_group C 

my Sbind.dn = $_[&]: 4 The user's? bind DU 

my ^password - 5 [i]; 4 The user's password 
my Sing.-eu = ¥ The CN of the Group 

my Sconn - new Nosilla:iLEAfr:C deui ($ldap_hoBt. $ldap_port, Sbind-dn. 

Spasawards ""l; 

if £l$connJ C 

html_ die piay.error( "Couldn't connect to the directory server."); 
exit(0); 

3 else E 

my Sentry = Sc.onn->searth[$search-base. "sub". h (cn=$mg_cn) p '3; 
if ((Sentry) £ 

html .display. error( "Couldn't find Smg.cn.; 
exit(0 ]; 

I 

Sontry-iaddValue("uniquememh-er'', Sbind dn) : 

$conn->update($entry): 

Sconn-JcloeeC); 

) 

DDJ 
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PROGRAMMER'S TOOLCHEST 



Examining JPython 

A Java test engine 
puts Python to the test 

Kirby Angell 


I f you are like me, you like writing tests 
for your code about as much as you 
like writing end-user documentation. 
Typically, you might write a separate 
application or module to test a module in 
your software application. This type of 
testing (called ‘unit-level testing 11 ) is usu¬ 
ally given short shrift—if it is included in 
the project plan at all. 1 don’t like writing 
unit-level tests in most modern structured 
programming languages. Since the test 
code is usually more complicated and 
harder to write than it should be t 1 end 
up not testing nearly as much as 1 should 
Intellectually, 1 know testing is good, but 
time spent away from coding the main ap¬ 
plication seems hard to justify emotional¬ 
ly. Then I stumbled upon JPython. While 
it may not be the ultimate answer, JPython 
can help you quickly produce unit tests 
for your Java packages. 

JPython is a freely available version of 
Python (http://www.python.org) imple¬ 
mented in 100 percent pure Java. Python, 
a cross-platform programming language 
implemented on most major platforms, 
can be used for a variety of purposes. 
Python’s abilities as a scripLing language 
are important when it comes to writing 
test applications. Features that make 
Python a good scripting language include: 

• No separate compile and link phase. 

• No type declarations. 

• Dynamic loading and reloading of 
modules. 

m Huge library of add-on modules. 


Kirby is a senior consultant with Dalaline 
Inc , He is also a Microsoft Certified Solu¬ 
tion Developer, Charter Member He can 
he reached at kirhya ngetlWhot ma ii com. 


• Access to the built-in compiler and 

bytecode interpreter. 

To this list, JPython ( written by Jim 
Hu gun in and available at http://www 
.python.org/jpython/download) adds 
seamless access to Java packages and 
classes. {When downloading JPython, I 
recommend you also download the 
Python L5.2 library. Part of Python's 
power comes from its extensive library 
of add-on modules. Tire standard 
JPython distribution comes with only a 
subset of the Python library,) Since 
JPython is implemented in Java and runs 
in the Java Virtual Machine, using java 
classes in Python code is trivial. As a 
scripting language with access to Java 
classes, JPython lets you quickly whip 
up a test of any Java class. 

There are two issues IVe run across 
concerning portability and JPython. First, 
JPython does not seem to work with tile 
KaffeJVM distributed with Red Hat Lin¬ 
ux (http://www.redhat.com/). However, 
it does work fine with the Blaekdown JVM 
for Linux (1 1 ttp://www, bl aekdown, org)„ 
Second, because JPython does on-the-fly 
bytecode loading, some Just-In-lime (JIT) 
compilers can have problems. Still, IVe 
written some pretty advanced code with 
JPython and have only had to turn oi l the 
JIT compiler once. 

JPython Console Interface 

Since JPython includes a console inter¬ 
face, you can begin using it without writ¬ 
ing any code. When you start JPython 
without any command-line options, you’ll 
see JPython’s startup message, as with Ex¬ 
ample 1(a), which uses the JVM shipped 
with JBuilder2. The “>»” is [Python's 


command prompt. From there you can 
begin typing any valid JPython command. 
I use this console interface extensively to 
explore the functionality of unfamiliar Java 
classes. By exploring their inner workings, 
I save time in the edit, compile, and test 
phases of Java coding. Let's say 1 just 
learned that the jam. matbMiglnteger class 
might solve my integer problems, but from 
the spartan documentation, I haven't fig¬ 
ured out how to use it. To explore this 
class in JPython, I must first make JPython 
aware of its existence using Example 1(b), 
This is actually the same syntax you would 
use to import a regular Python class. Next, 
I can try out one of the constructors for 
Biglnieger and view die results; see Ex¬ 
ample 1(c). 

The first line creates a new instance of 
the Bigfnteger class. As you'd expect, 
JPython looks for an appropriate con¬ 
structor of Biglnteger and creates a new 
object (hi). When displaying the contents 
of hi, JPython also looks Tor an appropri¬ 
ate way to display the object, by eventu¬ 
ally calling die toString mediotl of the ob¬ 
ject. If JPython cannot find Lin appropriate 
constructor, then it would report an ap¬ 
propriate error. If you wanted to test Big- 
Integer's max method, you could try Ex¬ 
ample 1(d). 

There is one JPython feature that 
makes scripts that use Java cleaner look¬ 
ing and sometimes easier to write. 
JPython uses die Java Bean Introspector 
to identify class properties either from 
common design patterns (methods named 
getX or setX) or from explicitly specified 
Bcanlnfo, Although illegal in Java, Ex¬ 
ample 2(a) lets you write this code us¬ 
ing java.util. Date's getHours and set Hours 
methods. 
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(continued from page 78) 
Unfortunately, I don't recommend us¬ 
ing this inside of your own JPython rest 
scripts. There is nothing wrong with the 
functionality—it works fine—hut I like 
being able to use my test scripts as sam¬ 
ple code for the consumers of my Java 
classes. Other developers reading my 
scripts really need to see the getX and setX 
methods that they would have to use in 
their own Java programs. This example 
without the Bean properties kx>ks like Ex¬ 
ample 2(b), It’s not as pretty, but makes 
for a better example of how to use the 
Date class. 

JPython Test Script 

Listing One is a JPython program to test 
the jam.math.Biglnteger- class. When you 


examine Listing One, you will see more 
involved tests of Biglnteger than those I 
just described, plus a new test for Big- 
Integers abs method. The structure of this 
program is typical of the lest scripts I first 
created with JPythom 

1, Print an introductory message (line 6). 

2, Perform one or more tests (lines 7-22). 

3, Print a closing message saying all is well 
(line 23), 

Python, unlike some scripting lan¬ 
guages, is a “reap language and supports 
procedures, classes, and inheritance. I cre¬ 
ated a base class (TestCase) designed to 
tnake the quick and consistent coding of 
tests possible. Listing Two performs the 
same tests as Listing One, but within a 


Python class derived from TestCase (shown 
in Listing Three). Although the Biglnte- 
gerTest class seems to be a bit longer than 
our first version in Listing One, it contains 
more functionality, and each actual test is 
shorter Since each test is segregated into 
its own class method, you can easily iden¬ 
tify the individual tests and add new tests 
without worrying about side effects from 
other tests. 

TestCase 

Before considering all of the intricacies of 
Python classes and the TestCase base class, 
kxjk at the ctxle involved in writing a sin¬ 
gle test. Compare lines 7-11 of Listing One 
and lines 9-12 of Listing Two, In Listing 
One, the code performs an operation, 
checks the result, and if the result wasn't 


(a) 

JPython 1.0.1 on 

javaJDKl. 1 .6_Borland 
Copyright 1997-1998 Corp, for 
National Research Initiatives 

>» 

(b) 

»> from java*math import 
Biglnteger 

(c) 

>>> bi = Biglnteger( "100" ) 

>» bi 
100 

w 

»> bi2 = Biglnteger( "200" ) 

>>> bi,max(h 12) 

200 


Example 1 : (a) JPython *s startup 
message; (b) making JPython aware of 
the existence of a class; (c) trying out 
(a) of the constructors; (d) testing 
Biglntegers max method. 


(a) 

>>> from java.util import Date 
>>> d - Date{) 

»> d* hours 
19 

>>> d.hours - 10 
>>> d.hours 
10 

(b) 

>>> from java.util import Date 
»> d ~ Date0 
>>> d.getHourn0 
19 

>>> d.setHours(10) 

>>> d.getHours() 

10 


Example 2: (a) Writing code using 
java.util.Date's getHours and 
sctHours methods; (b) a better 
example of using the Date class * 


Still reinventing? 


Still not using XRT components (or Motif? 

The XRT PDS (Professional Developers Suite) from KL Group includes all the tools you need for 
powerful, flexible interface development. Tables and forms that obey your every whim Charting and 
graphing capabilities that will blow you away. Data entry and validation widgeis that amicipaie the 
user's every move. And with the GUI taken care of, you can get on with building the rest of your 
application a lol sooner. The alternative? Continue lo reinvent the you-know-what. 

Fully documented. Fully supported. Royalty-free 

Evaluate the world's leading Motif widgets today 

www.klgroup.com yferteval 
or call 1-888-361-9161 
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what was expected, prints an error and 
exits. My problem with Listing One is that 
it takes some mental effort to construct 
the test, and this effort is duplicated in 
each test. The corresponding code in List¬ 
ing Two replaces the ^statement and the 
call to 1} with assert This method 

is defined in the lest Case base class. Like 
the standard assert functions found in oth¬ 
er languages, Test Cases method only 
jumps imo action if the statement passed 
to it evaluates to False (0 in Python). The 
single call to assert_ replaces the If print 
error, and exit functions in each test of 
the original code. 

You should also notice that what was 
a comment in Listing One (# Test String 
Conversion) is now in a special quoted 
string called a “docstring. r in Python, 
practically everything is an object, in¬ 
cluding the functions, and functions have 

a_doc_property that returns this 

quoted string. Since the docstring can be 
accessed programmatically, the tesi har¬ 
ness can now' display information about 
the test. In effect, a line in the test script 
that was useful only to the developer of 
the test is now doing double duty w hen 
the test is run. In TestCase, the docslring 
is printed to the console before the test 
is run, providing onscreen commentary 
for free. 


To run the new TestCase- derived unit 
test for Biglnteger, simply run JPython with 
tiie name of the script on the command 
line. Example 3 shows the results on my 
computer. 

When JPython loads BiglntegeiTestpy 
(available electronically; see "Resource 
Center, 11 page 5), it immediately executes 
lines 23-27, which eventually call Test- 
Case'^ runTest method, This method is 


responsible for executing the test meth¬ 
ods within the class. In addition, this 
method is responsible for creating the 
output just mentioned. 

runTest is the main workhorse of 
TestCase and any of the derived class¬ 
es. Using Python's inspection capabil¬ 
ities, runTest first obtains a dictionary 
of all the methods and properties avail- 
able in the class. If a method begins 


G:\Sample2 >j python 

BiglntegerTest.py 



19931102 22:51:21 

BiglntegerTest 

Test 

absolute value operator 

19981102 22:51:22 

BigIntegerTest 

Test 

max operator 

19981102 22:51:22 

BiglntegerTest 

Test 

string conversion 


Example 3; Running the new TestCase-deri ved unit test for Biglnteger. 


(a) 

exec ( '‘import %e ir % script ) 
module = locals 0 [script] 

# if this module supports our testing, interface 
if module.^_dict_ .has. key L ''addTests 11 ): 
module,addTests( ts } 

W 

def addTests( ts ): 

ts*add{ BiglntegerTest{ "BiglntegerTest*" ) ) 


Example 4; (a) Dynamically loading test modules; fh) example of an addTests 
method for the BiglntegerTest.py module , 


Real-Time Graphics Tools and Charting Tools - New 3.0 Revision 

The new features added to Revision 3.0 are based on 2 VS years of extensive customer research into the types of 
applications created using our software tools. Over 250 NEW user callable functions have been added to the software. 


Charting Tools 3,0 - New Features 

New Plot Types - Contour plotting, Open- 
High-Low-Close, Waterfall, and Candlestick. 

New Features Added to Existing Plot 
Objects - Multi-color plot objects, bitmap and 
metafile scatter plots, line marker skip factor. 

New User Interface Routines - Drag graph 
objects and data points with the mouse, super 
zoom up to 10 simultaneous x and y axes, 
XOR data cursors. 

New Auto-Axes Functions - Auto-axes 
graphs based on multiple datasets, auto-axis a 
single axis, auto-axes group datasets, auto¬ 
axes contour data, auto-axes existing graphs 



The Charting Tools supports mufti pie colors within 
line plots , scatter plots and bar graphs. 


New Axis and Axis Label Functions - Date 
labels, time labels. 

Mtsc. New Graph Features - Bit block 
transfers for flickerfess updates, add new 
objects to an existing graph, serialization, 
coordinate conversion functions. 

New Printing, Bitmap and Metafile 
Functions - Map graph to printed page, 
bitmap and metafile scatter plots, save graphs 
as a DIB, copy graphs to memory bitmap. 

New Text and Legend Functions - User 
definable legends, multiline text strings, 

Real-Time Graphics Tools 3.0 - In 
Addition to the Features Added to 
the Charting Tools 

New Real-Time Plot Types - Real-time 
scatter plots, real-time solid area fills, real- 
time multi-bar scrolling, real-time combination 
graphs and dynamic line graphs 

New Features Added to Existing and 
New Real-Time Plot Types - Bad data 
value handling, alarm colors for scrolling and 
sweep graphs, additional alarm colors added 
to annunciators, annunciator alarm limits for 
each channel, additional alarm zones for 



The Real-Time Graphics Tools supports scrolling 
lines, bars, area fills and scatter plot symbols 

meters, bit block transfers allow for 
flicker!ess updates. 

New Alarm Features - Dynamic datasets 
can have individual channel alarms. 

Common to both Charting and Real- 
Time Graphics Tools 

Compiler Support - 32-Bit only, Visual 
C++ 5, 6. Visual Basic 5, 6, Delphi 3. 

New Example Programs, On-Line Help 

The Graphics Class Libraries for MFC 
has been updated for MFC 6.0 


Product information, datasheets , pricing and demos are found on our web site at www.quinn-curtis.com 

Quinn-Curtis, Inc - Tel. 508-359-6639 FAX 508-359-4123 
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Attention Telecommuters: Get in the 



Fast Lane! 


if you telecommute and have a DSL or cable-modem 
connection at home, you could access your company's 
network using the same breakneck speed you've gotten 
used to at the office! Virtual Private Networking (VPN) is 
the answer. Compatible Systems' IntraPort 1 " family of 
VPN access servers gives you secure access to your cor* 
porate network via the Internet. Of course IntraPort 
works with all computing platforms (Linux, Solaris, NT, 
Mac, Win 95 and 9ft) so you can use all your familiar soft¬ 
ware programs. 

Com pa ti hie Systems has the answer to speed up your 
telecommute Register online to receive your free ' High 
Speed* t-shirt at www.compaiiblc.com/1iighspecd/ 

VPN that fills your need for speed. 1 * 


IntraPort and IntraPort Enterprise are 
trademarks til Compatible Systems Corp 
Atl oilier product names are trademarks of 
liieir respective manuloctuirers. 



1 Compatible Systems 

the VIRTUAL leader 

1.888.356.0283 

www.compatible.com 



iJljiif mUitiil yi'Jf • 


iirtpiljs 


WWW«VISKlt«€Olt1 

Free Uampire Demo Hvaileble! 


Changing The Way 


'Mm 

l/ai-Ti 


A New Real-Time 3D API For Windows 


with u iest_ t " nmTest performs the fol¬ 
lowing activities: 

* Calls the class initialize method. 

* Writes out the docstring. 

* Executes the method 

* Calls the reset method. 

When there are no more methods, 
nmTest exiLs. Since the initialize and re¬ 
set methods are executed before and af¬ 
ter each test, they ran hdd code common 
to all of the tests—rather like a function- 
level constructor and destructor. These 
methods also serve to ensure that each 
test is run in an environment separate from 
the other tests. This, together with each 
test lieing in a separate method, cuts down 
on side effects between tests. 

Remember that Test Case's assert_ 
method is responsible for reporting any 
problems in the test. Its main code is ac¬ 
tivated {inly if the expression passed is 
False. If the expression is False, the as¬ 
sert _ method outputs the name of the Ole 
and line numlxT where the assertion failed 
and calls the uriteErrar method to display 
the error message. K raise call at the end 
of assert_ sends the error back to the 
caller. In the ease of HiglntegerTesLpy, the 
error is simply ignored and the unit test 
exits. My feeling is that once the unit has 
failed one Lest, the rest of the tests are sus¬ 
pect. Once a test fails 1 do not bother run¬ 
ning any remaining tests on that unit. 

TestCase contains one other method 
that 1 have not discussed, failTesi keeps 
track of whether a test in this unit test 
has failed. If the unit test exits immedi¬ 
ately after a failure, why keep track of 
the failed test? 

Batch Testing 

Once you have imposed a modicum of 
structure on the unit-level tests, it is not 
a Far stretch to implement all sorts of au¬ 
tomated, batch, and regression testing, Hie 
testsuite.py and testeng.py scripts (both 
available electronically) implement batch 
testing, but they can easily be extended 
to support all manner of testing, while still 
allowing simple test cases to be written 
quickly. 

Testsuite.py contains a single class 
called Test Suite that does not really do 
much besides act as a collection class for 
the TestCase- derived class, TestSuite has 
the typical collection methods— add\ re¬ 
move, and count — lo manage the con¬ 
tents of the collection. The interesting 
methods in TestSuite are run, and nmTest 
actually executes all of the tests in the 
suite and a single test, respectively. The 
run method simply iterates through the 
collection and calls the nmTest method 
for each test. nmTest performs the same 
function that the u _main_" code did 
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in Listing Two. It calls TestCase's run Test 
method and intercepts any exceptions 
generated by the Lest. 

Testeng.py is the master integrator be¬ 
tween TestSuite r TestCase , and the unit-lev¬ 
el tests you design. Testeng.py loads each 
test class into a lest Suite, then executes 
the TestSuite by calling the run method. It 
accomplishes this magic using two cool 
features of JPython (and Python for that 
matter). First, JPython lets you dynamical¬ 
ly build, compile, and execute Python code 
on-the-fiy. Second, [Python provides func¬ 
tionality to dynamically load new modules. 
Near die end of testeng.py ? Example 4(a) 
dynamically loads each test module. 

The module is imported into JPython 
and a handle to that module is retrieved 
in the first two lines. If the module con¬ 
tains a procedure called aMTests, that 
method is called with a TestSuite object, 
allowing each module to control how tests 
are added to the test suite. Example 4(b) 
is an example of an addTests method for 
the BiglntegerTest.py module. 


Testeng.py will attempt to load any .py 
file in the current directory that does not 
begin with “test” (so testcase.py, Lest- 

JPython also makes 
an excellent tool 
for prototyping 
Java applets 


suite.py, and testeng.py will not be mis¬ 
taken for actual tests). 

Conclusion 

Since JPython is written in Java, it is 
straightforward to include JPython pack¬ 


ages in a Java application and use JPython 
as your application's scripting engine. 
JPython classes can subclass Java classes. 
JPython also makes an excellent tool for 
prototyping Java applets that are embed¬ 
ded in a web browser 

Still, the testing framework described 
here is not dependent on JPython. The 
code works unmodified under the DOS, 
Windows, and UNIX versions of Python. 
If your bailiwick is Windows and COM, 
the Python “win32alP add-in lets you 
test COM components the same way 
JPython lets you test Java packages and 
classes. 

The test harness included with this ar¬ 
ticle is basic in nature, but can be ex¬ 
tended, Its primary focus is to enable you 
to create unit tests with as little work as 
possible. In my experience, IPs best to 
write test cases quickly, or you won't write 
them at all. 


DPJ 


Listing One 

01: H 

02: I* BiglntegerTeSt. py 

03: N Teste the standard java class java.math.Biglntager 
04 r impart sys 

05: from java.Hath import Biglnteger 

06: print "Teat tbs standard Java BiglntEger tlaae." 

07: ¥ Test string conversion 

0g: bi = Biglnteger£ 'lECS" ) 

09 e if M.longValuflO 1-100: 

10: print "'Biglniegef string conversion failed," 

11: ays,exit(1) 

12: * Test max operator 

13: bil - Biglnteg«r( '100' ) 

14: hi2 - SiglntegoH '200’ ) 

15: if bil ,ma*£hi2) 1- 200: 

16: print "Siglnteger max operator failed." 

17: sya.exit{1} 

IB: W Test absolute value operator 
19: bi = Biglnteg€r( *-100' ) 

20: if bi.abst) (±= 100: 

21: print "Biglnteger abs operator failed," 
lh ays.exit0) 

23: print "All teste completed,■ 


listing Two 

01: ft 

02: 1 EigI ntege fleet. py 

03: ft Teste the standard java class java.math.Biglnteger 
04x import ays 

05: from java.math import Biglnteger 
06: from teatcairn import Teat Case- 
07: class BiglmiEgatTesE(TestCase): 

08i "Test the standard java Biglnteger class." 

09: def test.stringCdnverfiion(iJelf) e 
10i "Test string conversion" 

11: hi = Bigint*ger( ' iw ) 

12: self.assert.( bi.longVatuet) ** 100 ) 

13: dei test.maxOperator(self): 

I4i "Test max operator" 

15: bil - Biglnteger( *100* ) 

16: bi? = Biglnteger( , 200 1 ' ) 

17: self.assert.( bil.mexfhii) « 200 } 

15: def test_flbs{self): 

19,: "Test absolute value operator" 

20: bi - Biglnteger{ '-100' ) 

21: self.assert ( bi.abaO *= 100 ) 

22: if _nsma_ 

23: try: 

24: c - BiglntcgerTestt H BiglntegerTest" ) 

25: c.rtmTestO 

26: except: 

27: pass 


Listing Three 

01: import sys 

02: import traeshack 

03: import os 

04: from time import * 


05: from string import * 

0b: claflS TestCaSe: 

07: "Base class for python based unit level and regression tests. 

08: To use this class, implement the runTeet. initialise. and reset \ 
09: methods. Call the assert, method to tost for success." 

10: def _iftit__ (self. name): 

11: self.testName - name 

121 seif.failed = 1 

13: self.failureReason - "<<Not TestedJ>" 

14; def runTeat(eelf}; 

15: "Run che test methods in tbia class" 

16: names = dir( self,_ c1b?s__ ) 

17: self.failed - 0 

18: self,farlureRoason = 

19: for name in names: 

20: H if this is a test method 

21: if name[;5) — "test "i 

22: self.initialiseC) 

23i try: 

24: func = getattrt self, name } 

25 1 self.writeMessage{ fimc._doc_. ) 

26: it Execute the test 

27: funcQ 

28: finally: 

29: self.resetC) 

30: def initialixie[self): 

31: "Called before each test is run. Should be overridden." 

32: pass 

33 e def resetiself): 

34: "Called after each test is run. Should be overridden," 

35: psss 

36: def £eilTeet(seif, reason}: 

37: "Hark this test as having failed," 

38: self,failed = 1 

39: self. f ailtlteRessoft - reason 

40: def writaWessage(self, message); 

41: "Writes a massage to the standard output davlce." 

42: self ^writeMeBsaga(flyB.atdout, message ) 

43: def WriteErtor(self. ertot )1 

44: "Writes an error to the standard output device." 

45: self.writaMessage{ sys.stdout, "ERR " + ertot ) 

46: def writeWarning(self, warning): 

47; "Writes an warning tn the Standard output device." 

4B: self...writeMessaget iys.stdout, "WRW " +■ warning ) 

49: def _.WriteMeSsage(Seif. oUtFile. message): 

50: year, month, day, hour, minute, second, weekday. JulianA 

51: daylight - Itjcaltlme(time0) 

52: outFile,write( ir ft04d*02dft02d ft02d:ft02d:%©2d\t" ft (year A 

53: month, day, hour, minute, second) ) 

54: outlils, write( "ftsVfftsXn" ft [self.testBame. message) ) 

55: def assett_(self, teat): 

56: "Logs and generates an error if the test is false-' 1 

57; if test == 0: 

5B: stack - traceback.extract_stack[) 

59; staCkFrame = stack [lei: (stack)-2] 

60; file,line.method.call = ctackFrame 

61: path.file - oa,path.Split{file) 

62: source = "fts fts fts ftc" ft (file, line, method, call) 

63: self.failTest* "Assertion failed: fts" % source ) 

64: self.writeErrorf self,failureReaeon ) 

65 i raise AasertionErtor, source 


DDJ 


Dr. Dobb’sJournal, April 1999 


83 








PROGRAMMER'S TOOLCHEST 



Porting C++ Code 
from NT to UNIX 

Using the MainWin XDE toolkit 
George F. Frazier 


V M JV hen Microsoft released Windows 
lAv developers started get- 

UU ling demands For their software 
W W on this new platform* Since the 
advent of Windows NT 4*0 and the ex¬ 
plosion of TCP/IP and Lhe Internet onto 
the non-UNIX desktop, thousands of pro¬ 
grams have lieen ported to Windows, Par¬ 
ly ports were often only a glorified re¬ 
compile decorated with an after-the-fact 
GUT that replaced the command-line in¬ 
terface* 

In contrast, today’s major cross-platform 
tools are just as likely to have started out 
on Windows as on UNIX, Software de¬ 
velopers are finding that customers in the 
midst of migrating from Solaris or HP to 
NT still want UNIX diems (if not full¬ 
blown applications) that run on their old 
boxes. Thus, more and more program¬ 
mers are doing something that once felt 
inherently backward f if not evil}— port¬ 
ing from Windows to UNIX* 

For large C++ programs, the most re¬ 
alistic solution for porting from Windows 
to UNIX is to use a tool that implements 
the Windows API natively on the target 
system. One such product is MainWin 
XDE (extended Development Environ¬ 
ment) 3d from MainSoft (http://www 
,main.srjft.com/), The company I work for 
recently finished porting a major appli¬ 
cation from Windows NT to Solaris, us¬ 
ing MainWin with satisfactory results. 
MainWin provides MFC Libraries* com- 


Ceorge is a member of the consulting staff 
for Cadence Design Systems , He can be 
contacted at gmrgeJ^cadence.conL 


mon controls* a resource compiler* help 
engine, automatic makefile generator, spe¬ 
cialized source files to include wilh ap¬ 
plication programs, and a whole set of tools 
that implement the cross-development 
environment on target systems* Die ad¬ 
vantages provided by using MainWin in¬ 
clude a common code base, a relatively 
easy porting step with regards to compi¬ 
lation and linking, and an application that 
executes native code on the target plat¬ 
form* You can also offer either a Win¬ 
dows or dnotiF' look to your programs. 
The principal disadvantage of MainWin 
is a sometimes sluggish (but certainly not 
intractable) run-time performance with 
regard to graphics. 

In this article, I’ll discuss the specifics 
of using MainWin to port an executable 
application that compiles and mas in Win¬ 
dows to UNIX* III discuss preparing the 
Windows code and planning the port to 
UNIX, preparing the UNIX environment, 
dealing with third-party libraries, gener¬ 
ating MainWin makefiles, building the pro¬ 
ject, and several run-time hurdles that you 
might have to clear. Along the way, 1II 
point out stumbling blocks that repeated¬ 
ly caused us headaches and some inter¬ 
esting technical hurdles that MainSoft had 
to handle to provide its relatively seam¬ 
less integration. 

The MornWin Environment 

Currently, MainWin is supported for 
SPARC Solaris 2.5.1. HP-UX 10.20, and SGI 
Irix 6.2 through kix 6.5. You’ll also need 
Native XI1 Release R5 or R6 on all sup¬ 
ported platforms, MainWin runs on top 


of X Windows interacting w ith both the 
the X Server and the window manager. 
Many window managers are supported, 
including twm, olwm, mwm, vuewm, 
4Dwm, and olvwm. For most uses of 
MainWin a few environment variables 
need to be set. MWHOME refers to the 
root directory of your MainWin installa¬ 
tion. MWREGISTRY stores die location of 
your registry file. Depending on your OS, 
the run-time 1 libraries, MFC libraries, set¬ 
up scripts, and other features are stored 
in logically organized directories under 
the installation root. One of die first tilings 
you’ll notice using the tool is tliat it’s much 
easier to find things with this hierarchical 
organization than in Windows, where 
most applications, DLLs, and help files 
are dumped in two main and several oth¬ 
er lesser installation directories* 

An important issue in planning any 
cross-platform development effort is the 
basic problem of how to access source 
code on multiple platforms. In my case 
1 used CleaiCase* Rational's multiplat¬ 
form code-management system (http;// 
www, ration al * com/). You could also use 
a shared file server. Clearly, die headaches 
caused by copying code back and forth 
between systems either via FTP or flop¬ 
py disks far outweigh any time that you 
might spend in setting up a proper code¬ 
sharing schema. 

Planning the Port to UNIX 

My first worries when faced with port¬ 
ing a large Windows program to UNIX 
centered around die ignoble task of plac¬ 
ing Hfndef WIN32 directives around the 
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The clock is ticking and the project deadline is drawing near. If you had used 
Multi-Edit as your source code editor, you’d be finished by now. 


Filled with timesaving features, Multi-Edit gives you the power you need to meet those deadlines with 
fewer keystrokes and time to spare. Features such as template expansion, code navigation with collapsible 
editing, code completion, and construct matching all combine to make Multi-Edit an effective tool in 
enhancing your productivity. 


Completely flexible and fully customizable, Multi-Edit can be configured to your specific preferences with 
reconfigurable keymapping, toolbars, and menus. You have the power to interface all your tools into one 
seamless environment to create your own editing realm. The ability to make your own macros allows you 
to mold and shape Multi-Edit to act and respond the way that you need it to. Edit any size file and keep 
results easily accessible in a tabbed Results Window pane. Program in multiple languages with extensive 
support for more than 80 compilers and edit web pages with incredible technology for programming for 
the Internet. The possibilities are endless! 


For a full list of features, to try Multi-Edit for free, and for more information on how you can experience 
true productivity, visit our website; ^ 

www.multiedit.com 

For Power and Productivity 




1830 W. University Dr., Suite 112 

Tempe.AZ 85281, USA 

(800) 899-0100 f sales@multiedit.com 



9 Outside the US & Canada, contact Soft/Export, Inc. info@sofiexpcit.com (UK)GBOO 973 098 (FranceJQBDO 905823 (GermanyJOIBO 860341 Infl Inquiries: +353 1 294 2121 

998 American Cybernetics, l™_ Multi-Befit, the Mufti- Ml logo, American Cybernetics, and the American Cybernetics fiigo arc trademarks of Amcm-an Cybernetics, Inc. All other trademarks are the property of their respective (nvners. 




Serious Copy Protection and 
Software Licensing with No 
Hardware Key or Disk Key 


• I tflfV Distribute your software via internet, 

• 1 CD or floppy with full security. 



HM A 


CrypKey provides solid copy protection with a 
broad range of features to control all aspects of 
your product's operation, You can offer free, 
automatic one-time trials, turn demos into full multi¬ 
user network versions, or sell specific options by 
phone, fax or email, Sell usage by time, runs, 
features - the control is all there - easy to implement, 
and even easier to support. 

CrypKey also offers choices - integrate our SDK 
into your software, or use CrypKey Instant to 
protect your compiled exe in 5 minutes; no coding. 

Try it free from our website to see why we’re 
rated #1 by professional programmers who seek 
the best combination of security, features, ease 
of use, reliability & price. 


100% Satisfaction Guaranteed! 


http://www.crypkey.com ◄ 

Ke nonk Controts Ltd,, Calgary, Can ada P h: 40 3^2 53-6200, Fx: 403-2511-6201. em a II; lnfo@cry pkey.com 


(continued from page 84) 

Windows API calls and replacing them 
with UNIX and X commands. But since 
MainWin implements the Windows API. 
none of this is necessary. In fact, having 
worked on nontrivial ports before, 1 
wasn't ready for the relative luxury of 
porting using MainWin. One of the para¬ 
doxical tricks about this port was that 
the traditionally platform-safe practice 
of protecting OS-specific calls with pre¬ 
compiler directives actually backfired 
with MainWin because it defines WIN32 
and _WIN32! 

Although you don’t need to isolate the 
Win32-specific code in your project, it 
is important to verify that it compiles and 
links properly on Windows. It was our 
experience Lhat taking the time to debug 
and tesL Lhe code on Windows first saved 
considerable time on the UNIX side ( here 
there were invariably several compile 
and run-time issues to deal with no mat¬ 
ter how meticulous t Lried to be in an¬ 
ticipating the UNIX port). You will also 
need to obtain thoroughly tested ver¬ 
sions of any third-party libraries that are 
required by your Windows project. This 
step alone can cost weeks of schedule 
time If the libraries are unavailable or 
worse yet, need to be ported or coded 
from scratch, 

A MainWin project is a collection of 
MainWin modules. MainWin modules 
produce either an executable, DLL, or 
static library. If your Windows project is 
sufficiently complex, or if you are unfa¬ 
miliar with the layout, you might want 
to create a link dependency table to sug¬ 
gest the build order in the MainWin 
makefile, figure 1 shows die directory 
structure of the simple Windows project 
Testbench (available electronically; see 
"Resource Center ,*' page 5), an executable 
that links against a DLL (DLL1), two li¬ 
braries CUIU and LTB2), and an OLh con¬ 
trol (ActiveX!). In addition, DLL1 needs 
a third-party library (LIE3). The module 
types can often help you determine de¬ 
pendencies because applications often 
depend on static and shared libraries, and 
other libraries and executables usually 
include controls and libraries. Table 1 is 
a link-dependency table for Test Bench 


TestBench 


DLL1 UBt LIB2 ActiveXI 

I 

L1B3 


Figure l; TestBench directory 
structure. 
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derived from the directory structure of 
Figure 1. Remember that run-time de¬ 
pendencies such as dynamic linking and 
automation can be ignored when deter¬ 
mining build order because they don’t 
affect the compile and link process. 

Generating a MainWin Makefile 

Tile only significant new code that you’ll 
have to write in porting a Windows pro¬ 
ject to Main Win involves custom make¬ 
files for each Windows project. Whereas 
Microsoft insulates you from the details of 
the actual makefile syntax, MainWin re¬ 
quires that you delve into the nitty griuy 
of makefiles to support your applications 
on UNIX. The MainW'in utility mwgen- 
make partially automates the process of 
generating makefiles, but the bulk of the 
work consists of customizing the scripts 
via a suite of MainWin defined variables 
in Figure 2. A MainWin makefile is still 
fairly simple compared to a standard UNIX 
makefile because each of your makefiles 
will in turn include one of the generic 
main win makefiles that do most of the 
work for you. 

The project Test Bench consists of: 
Test Bench xpp t matnxpp, Test Bench. re. 
Testbench.def' t and Test Bench. idL The 
first step in producing a MainWin make¬ 
file is to run mwgenmake in the home 
directory of Test Bench (where all of the 
source files reside! Mwgenmake will put 
all C and C++ files in this directory into 
the makefile it generates. In addition, it 


will look fora module definition hie (.clef) 
for the module name type teither exc or 
.dll), and whether the module is an MFC 
ActiveX control Cocx). You can run mw¬ 
genmake from the command line or use 
the wizard version that is invoked with 
no parameters. The basic information con¬ 
tained in die makefile is a list of die suunu 
files for our application Testbench, its type 
( exc), iLs name (Testbench), names ot die 
Windows and UNIX resource tiles, com¬ 
pile flags (that enable you to .specify die 
include file directory, a path to the h flies, 
and whether to build optimized 01 debug) 
and link flags (to specify a list of libraries 
to link against), and the dependencies ot 
the project. 

Listing One is the actual makefile tor 
our project. Of course you II need to gen¬ 
erate a separate makefile for every Main 
Win module that Ls part ot your piujea. 
Also, 1 edited die makefile to include link 
dependencies and include pains. 

Building the MainWin Project 

By the time you get around to compil¬ 
ing your newly created MainWin piu 
ject, the brunt ot the work shifts from 
fitting your code into the MainWin 
schema to ihe inevitable fighting with 
compiler differences. A lull list ot the 
differences between the Miuusoft visa 
ai C++ compiler and the various UNIX 
compilers is beyond the scope and pui- 
pose of this article. Suffice il to say tuaL 
tile supported UNIX compilers deal with 


Module 

Type 

Link 

Dependencies 

Run-time 

Dependencies 

Build 

Order 


DLL1 

DLL 

UB3, LIB2 

none 

5 


UB1 

lib 

none 

none 

1 


LIB2 

m 

none 

none 

2 


LIB3 

lib 

none 

none 

3 


ActiveX 1 

OCX 

LIB1 

TestBench 

4 


TestBench 

exe 

ActiveX 1, DLL1 

ActiveX 1 

6 



Table I: L in k- dependency table for iesiuench. 


RUN,dir 

directory where you want executables to go 

COMPILE.OPTION 

can nave tne values: debug, optimized 

APP.CFLAGS 

additional compilation flags for C compiler 

APP.CCPPFLAGS 

additional cuinpilation flags for C-H compiler 

APF.LBFLAGS 

additional link flags (maybe specifying DLLs) 

MWINIT,_ DEFINES 

list of -D<syiaijule> used to initialize 


Mainwin in certain specific Way* 

MWLOGALES 

list of codes corresponding to the 


resumes you have prepared in tct. 
subdirectory 

MIDL.IDL 

ILL file to ue compiled with MIDL 

MIDL..IID 

lid file from MIDI (default: <idi_name>_i,c) 

MIBL_PROXY 

Proxy implementation from MIDL (default: 


<idl .name;-, p.e) 

MIDL_HEADER 

Header with interlaces and GUlDs (default: 


.h) 

MIDL DLLDATA 

DLL data ioi pj-oxy from MIDL (default: dlldais.c) 

MIDL.TLB 

Type lib ini Dima cion from MIDI (default. 


Sidl.uau.e^ . lIo) 

this will Le created in the (RUN.dir] dilatory 


Figure 2; User-configurable variable* used in Main win makefiles. 
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ABRAXAS 

Software, Inc. 


CODEFIX- 
Version 1.0 


PCYACC* 
Version 8.0 


CodeCheck 

Version 8.0 


SOURCE CODE 
MODIFICATION 

CODEftX Version 1.0 is a 
programmable tool for 
modifying alt C and C++ 
source code on a file or 
project basis, 
m Calendar (Y2K) symbol 
identification, commenting, 
and correction. Foreign and 
domestic calendar problems 
can be found and corrected, 

■ Program Layout 
Modification. 

■ Obfuscation and shrouding 
for C++ programs. 

■ insertion of code for dynamic 
runtime testing, 

■ Generating HTML 
Documentation from C++ 
programs. 

■ Database generation from 
C++ source code. 


PROFESSIONAL 
LANGUAGE DEVEL¬ 
OPMENT TOOLKIT 

Indudes “Drop In " Language 
Engines tor SQL, dBASE, 
POSTSCRIPT, HYPERTALK, 
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RPG, REXX f PU, SNA, RTF, 
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VHDL HTML VMRL, JAVA, 
ODMG-ODUOQL SQL3, MOD- 
ULA-3 r DELPHI, VBS, and ADA. 

■ Portable Object Oriented 
Classes tor C++ and JAVA- 
Error, Symbol Tab Is, Syntax 
Tree, Yacc, and Lex, 

■ Debugging toots include 
runtime Visual Parser 
Debugging, Abstract Syntax 
Tree generation, and Cross 
Referencing. 


SOURCE CODE 
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includes “Drop-in " Rules 
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Measures of complexity, Silent 
error detection. Code maintain¬ 
ability, and Portability. 


30 day Money back 
guarantee! Free AIR 
Shipping anywhere in 
the world! 


www.abxsoft.com 

ABRAXAS 

Software,Inc. 

4726 S,E. Division St. 
Portland. OR 97206 

TEL (503) 232-0540 
FAX (503) 232-0543 
E-Mail: $ales@abxsott com 



DOS $495, WIN 98/2000 $995, UNIX $1995 To Order Call 

_ 1-800-347-5214 






CM I offers a broad range of consulting services 
in Software Configuration Management, 
Requirements Management, and software 
manufacture for software development 
organizations - from training 
fa process outsourcing. 


Configuration Management, Inc. 
1-800-550-5058 

140 Broad St T Red Bank, NJ 07701 
Tel 732 450-1100 • Fax 732-450-0715 
E-mail: dcfj@softwareconfiguration.com 

www. softwa reconfiguration, com 


templates differently, have varying de¬ 
grees of ANSI compliance, and will like¬ 
ly generate unexpected warnings, if not 
errors, at first. Re particularly stealthy in 
your search for problems that arise from 
differences in naming conventions be¬ 
tween Windows and UNIX. Hard-coded 
path strings will generally not be valid 
on a UNIX system and will cause prob¬ 
lems at run time. MainWin provides the 
preprocessing tool mwprepro that con¬ 
verts both the names of files found in 
#include directives in the source code 
and the names of files found in the cur¬ 
rent directory to lowercase. This was too 
violent a treatment for my taste , so 1 
searched for these problems by hand 
(and not without cost!). Other possible 
prebuild steps might include rewriting 
assembly-language routines and remov¬ 
ing all instances of language features that 
are only supported in Visual C++, such 
as full method names within class defi- 
n it ions, extraneous semicolons, remarks 
after tfendif, empty arrays within struc¬ 
tures, nameless structures or unions, and 
the use of large integers. 

You'll be ready to make an initial stab 
at building at this point. To execute Main- 
Wins make utility on your project, run mw- 
niake in die directory of each of your Main- 
Win projects in the predetermined build 
order. The MainWin build system, through 
mwmake, will automatically invoke the 
MainWin DIP utility mwdip at link time to 
build a file that includes all necessary DLL 
initialization according to the order found 
in the link line of your makefile. This is im¬ 
portant to note if you are using a utility 
other than mwmake to build (such as make 
or cleamaake). In this case yotill need to 
invoke mwdip explicitly. 

Again, there are a host of issues that will 
likely cause your Initial links to fail. You 
may often run into duplicate symbols, mul¬ 
tiple included files, unresolved symbols, 
and so on. If you are working with a non- 
MFC project and the linker produces an 
error about the symbol WinMaini ) l>eing 
multiple defined, you must make sure that 
the makefile TYPE was not incorrectly de¬ 
fined as MFC, causing the linker to add 
standard MFC WinMainO entry points to 
your code. A similar problem is a multiply- 
defined main() symbol, defined in the file 
Main Win .c, a file that is compiled into all 
MainWin projects. If you have tnaini) de¬ 
fined in your code, you will need to add 
Example Ka) to your makefile. Then, die 
file tliat contains your definition of main/ ) 
includes Example 1(b). This is only nec¬ 
essary for C++ source files. 

Run-Time Issues 

Run-time problems (aside from your own 
bugs) that you may encounter with a 
newly created MainWin port include: 
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(a) 

APP_CFLAGS ~ -Duiain=app _main - DWHAS_APP_MAIN 

(b) 

extern ”C W 

int jnainCint argc, char *argv[]); 

[ 


Example 1: If you bate main() defined , add this code to your makefile; (b) the 
file that then contains your definition of main() includes this. 


T estBench+XmFrame.Background: 

#cococo 

T estBench * Xm Pus h Bu tton. Backg round: 

#cococo 

T estBench* XmMenuBar. Background: 

#cococo 

TeslBench*Xm Pul 1 Down Men u. Backgrou nd: 

#AAAAAA 

TestBench * Xm D raw i ng A rea, Backg rou nd: 

#FFEBD7 

TestBe nch * Cl rentTit! e. Backg rou nd: 

#cococo 

TestB e nch * Cl ient.Backgrou n d: 

#cococo 

TestBench * X m R adio Box. X mToggleButton. Bac kg round: 

#cococo 

TestBe nch= 1 = X m C h eck Box, XmloggleButton. B ackg rou nd: 

#cococo 

T estBe nch * Xm Del a u ItP u shButton. Backgrou nd: 

tcococo 

TestBe n ch * Xm Me n u Bar. Xm C ascadeButto n. Bac kgro u nd: 

ftCOCOCO 

TestBench+X m P u 11 DownM enu. X m CascadeButto n. Bac kg round: 

#AAAAAA 

TestBe nch•*XmPullDown M en u* Xm P ush B utton Backgrou nd: 

#AAAAAA 

Test Be nch * X m P u N Down M en u. X mTogg] eButto n. Bac kgro u nd; 

SAAAAAA 

TestBe nch m Sep arator. Bac kg ro u nd: 

#COCOCO 

TestBe nch+X mMe n u BarB reak. Backg r ou nd: 

#C0C0C0 

TestBench * Horizonte \, XmScro j 1 Ba r* Backg round: 

#cococo 

TestBenc h * Ve rlical, XmSc rol IBar. Bac kgro u nd: 

#C0C0C0 

TestBench * M a rg in Width: 

1 

TestB ench * ShadowTh ickness: 

1 


Windows NT language support, memo¬ 
ry APIs, global handles, byte ordering, 
DDR functions, DCOM, asynchronous 
communication, and various ActiveX API 
functions. Particularly common run-time 
glitches pop up when dealing with the 
registry, programs with multiple threads, 
and customizing the look of your appli¬ 
cation. 

All MAINWIN registry changes made at 
run time affect only the memory copy of 
the registry file. You can use die API func¬ 
tions RegCreate.../RegSet. .. to make dianges 
to the registry at run time. This precaution 
prevents ambiguities due to multiple write 
operations by different Main Win processes. 
To save registry' updates between sessions 
set MWAUTO_REG_SAVE to true. 

MainWin assumes that you are work¬ 
ing in a threadsafe environment. You 
may encounter problems if you run on 
a nonthreadsafe platform. These prob¬ 
lems are likely to pop up in relation to 
the display (display lockups are com¬ 
mon). But because developers sometimes 
have to use nonthreadsafe libraries like 
Xlib Release 5 on lrLx, and because many 
programs have only one thread, Main¬ 
Win does not require a threadsafe X li¬ 
brary, So an application that is not thread 
dependent and runs on nonthreadsafe 
software should work if ported with 
MainWin. 

Finally, it is possible that you won t 
be satisfied with the default Motif colors 
or the default shadow thicknesses/mar¬ 
gin w idths used by MainWin in the Mo¬ 
tif look. You can modify the motif look 
of your application by adding the fol¬ 
lowing X Motif resources in Table 2. The 
values are sample values suggested by 
MainSoft. 

Conclusion 

Reading this might cause you to won¬ 
der whether it would be better to just 
rewrite your program in Java. Til admit 


Table 2: X Motif resources for Test Bench. 


that lighting with compiler issues, make¬ 
files, and a host of other unforeseen road 
blocks is not my favorite software de¬ 
velopment activity. In many situations 
Java is a better solution. But in our case, 
wc had a significant investment in our 
C++ code base. We weren't willing to 
give up the many person-years we had 
invested in programming and careful op¬ 
timization that would be lost in a java 
rewrite. 

In short, we found MainWin to be an 
adequate solution to tile vexing problem 


of porting a large nontrivial NT software 
product to UNIX. 


For More Information 

Mainsoft Inc. 

1270 Oakmead Parkway, 
Suite 310 

Sunnyvale, CA 94086 

408-774-3400 

h tt p ://www r . ma i nsofl .com. 


DDJ 


Listing One 

ifeq ($(CDKPUA_OFTI0N). debug) 

CFG&upra-d 

else 

CFG5UFFIX= 

co«F I LE_OraOJNopti»ted 

endll 

RDH.dir^/Te e tEtennh/bIn 

PROG - TestEench$ ECFGSUFFIX} 

TYPELIB, FILES = ${FRQG),tlb 
KIJL_TLB=${PR0GJ, tlb 

WRESOURCE = ${PRQGJ.ec fl Windows resource 
nysSDURCE = $(FRQGJ .sitt * program 
MIDL _IDL=$ L FROG 3.odl 

AFP_CCPPfLAG&=—r/testbench/include include -DRW_HG_5TL 

-D_REENTRANT 

SOURCES * \ 

TeBtSench,cpp \ 
main.cpp \ 

lnvtJpdatedepKtbdenLiieEl-depeild-stlnQES 

CPP_QBJS = $ (SOURCES: %. C=^. o J 
CFF-0BJE ; = $CCFF_0BJS cpp**. o) 

GPP.OBJS i= $ECPP_OBJS:%.cxx=%,d) 

□BJS = $tCFF.OBJS:%.c^E.o} 


SRCS = $[SOURCES! 

wm _VERBGSE=t rue 
fWUSE.DLE.LIBS = true 
LDE3tTEftNAL= \ 

-iSimDefS [CFG5EJFFTX1 \ 

-lcddbutil$[CFGSUFFIX) \ 

-ltypesECCEGSUFFI^ji 
-1AItaSt ringS[CFCSUFFIX) 

AFF LDFLAGS = \ 

-lActiveXL$ [GFGSUFFDO \ 

-1DLL1$ tCFGSUFFIXl 

cplusplus - true 

=f£ MFC library related definitions. 

4If Removing these definitions disables linking with MFC. 

MFC MODULE.TYPE can be one of the following: DLL. EXTENSlON_DLL„ EXE 
HFC.HGDU LE_TYPE=m 
MFC LIB.ROOTsmfc400 

include $[MVH0ME)/make.rules.simple 


DDJ 
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Languages, protocols, tools, and technologies change. 
Set the pace and stay on track with in-depth courses and 
immersion programs from ObjectSpace. Our educational 
SWAT teams propel you up the learning curve to get you 
precisely where you need to go. Education 
and Training. ObjectSpace leads the industry 
with over 30 field-proven courses spanning Java, 
Distributed Computing, Smalltalk, C++ and more. We 
blend lectures and discussion with strong hands-on 
training. Our certified faculty have years of real-world 
programming expertise, so you learn the skills you 

really need. Immersion Programs, only 


1.800.0BJECT.1 

www.objectspace.com/train_now 


ObjectSpace boot camps offer intensive training 
tailored to your needs. Highly focused classroom work, 
team building and mentored project development start 
you designing and developing new, strategic business 
solutions now. Bring your entire team up to speed in 
object technology while learning how to organize 
project teams more effectively. Why wait? We 
deliver all courses and programs at your site or ours. 
Don't let fast-changing technologies leave you behind. 
Get the people, process, technology and training that 
propels you to point B — fast. To find out more, visit 
www. objectspace. com/train_now. 
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Blarney 

and Steve Jobs 



Michael Swaine 


S ince this issue should lx? getting into 
your hands somewhere between St. 
Patrick Is Day and April Foul’s Day, and 
since I am half-Irish and half-fool, die 
following items, some full of blarney and 
some only half-full, seem appropriate. 
Topics to be covered in today's lecture 
include: Y2K insight from the I Ching, die 
Blarney algorithm, a trip into Steve Jobs’ 
Reality Distortion Field, and rumors from 
beyond Transmetareality. 

Let’s dispose of the pesky Y2K crisis 
righi away. Lest you begin to doubt that 
I am ever-vigilant for fresh perspectives 
on Y2Kgate, f pass along for your edifi¬ 
cation the following observation, which 
has been taking up space in my e-mail 
inbox since last March: 

The Chinese undoubtedly have the longest 
experience with the Millennium bug. The 
/ Ching was worked out 5000 years ago, it 
has a S-bit word and the carry hit was nev¬ 
er invented. 

—Pushkar Piggotl 

Mr. (Ms.?) Piggotl doesn’t report what 
the T Ching has to say about die Millen¬ 
nium bug, but the fact that it has contin¬ 
ued to operate through 50 century-counter 
rollovers is encouraging. 

Perhaps the I Ching can help with a 
particular Y2K problem that I just read 
about. 

Apparently you can save yourself mon¬ 
ey by buying your tombstone before you 
actually need It, on the assumption that 
stone will appreciate in value faster than 
your programming skills. It f s also just more 
convenient to make purchases while 
you Ye still alive. 

And apparendy you can save even more 
if you get as much of the carving as pos¬ 
sible done ahead of time. This requires 
dial you make certain assumptions, such 
as that you wad remain Lhe beloved father 
of etc. You can see where tliis is leading. 


Michael is editor-at-large for DDL He can 
be contacted at mswa ine@swaine, com. 


A lot of people took this stone-carving 
cost-cutting advice to such an extreme 
dial diey had "19 M carved into stone as the 
first two years of their death date. Now, 
unless they really luck out and die in the 
next eight months, they face having to 
change the carving. And it’s really hard to 
erase in tills medium. Kudos to the pro¬ 
grammer who first comes up with a soft¬ 
ware patch for this one. 

Only Half Blarney 

It s a great story. Even if it isn’t entirely true. 

Only once in a blue moon do die dead- 
tree news sources give front-page treat¬ 
ment to the development of a new algo¬ 
rithm. IPs not as easy a subject to cover 
in journalese as, say, candy-colored com¬ 
puters. So it’s particularly entertaining that 
when the Times of London and various 
other newspapers decided to play up a 
new algorithm, it was an encryption al¬ 
gorithm. 

Here’s what I mean: With enough time 
and patience, you could probably explain 
a sort routine to any reasonably bright 
person. You could also probably get 
across the gist of a graphics compression 
algorithm to most of a class of tenth- 
graders, if they’d sit still for it. But en¬ 
cryption is something else; if you start try ¬ 
ing to explain what’s going on in a 
public-key encryption algorithm, you 
could easily find yourself bogged down 
in linear algebra, number theory, combi¬ 
natorial mathematics, Fourier analysis, cod¬ 
ing tiieory, complexity theory, statistics, 
or probability theory. I suppose that in¬ 
spired explainers can get the basic con¬ 
cepts across to a broad audience, but it 
ain’t easy. Encryption is obscure. Which 
is perhaps why they got the story wrong. 

"An Irish teenager has developed a fast 
security-encryption mechanism for e-mail 
that has Lhe potential to replace the 22- 
year-old system in use today," says Tech- 
Web News . 

“Making your e-mail secret is now 30 
times faster, but the innovation has come 


not from a multinational computer but 
a schoolgirl from Blarney, Ireland,” said 
the BBC. 

"A 16-year-old Irish schoolgirl is being 
hailed as a genius for developing a way 
of encoding data on the Internet 10 times 
faster than systems used globally now ,” 
said Reuters. 

Most of what they report is true, Sarah 
Flannery is 16, or was at the time of the 
stories, and she is Irish, from Blarney, in 
County Cork. She is also very bright. She 
has won more than one award in presti¬ 
gious international science fairs, one of 
them landing her a trip to Texas and a 
handshake from semiconductor legend 
Gordon Moore last year. 

And she did come up with a public-key 
encryption algorithm that is faster than 
RSA. But it appears that lhe newspapers 
(but not Flannery} may have exaggerated 
a little about how original the work is and 
how useful it is. 

Flannery began the work on the algo¬ 
rithm while working at Baltimore Tech¬ 
nologies in Dublin on a student work 
placement in March, 1998. (Baltimore, a 
major name in encryption, merged in Jan¬ 
uary 1999 with die British encryption com¬ 
pany Zergo ) According to William Whyte, 
Senior Cryptographer at Baltimore, the 
company gave Flannery the problem to 
work on, “We’ve been looking at algo¬ 
rithms based on 2x2 matrices for a while,” 
he said “and gave her the idea to see wliat 
she could do with It.” What she did, ap¬ 
parently, was to work out a public-key al¬ 
gorithm that is considerably faster than 
RSA, and equally .secure. 

This is impressive, and she no doubt 
deserves ail die scholarship and job offers 
she’s l>een getting. And 1 applaud her de¬ 
cision not to try to patent her algorithm. 
But it may be no more than cryptogra¬ 
phers at Baltimore had already achieved, 
and it may have drawbacks that make it 
impractical as an alternative to RSA, As 
the Baltimore cryptographers worked it 
out, “both the key and the ciphertext are 
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about eight times the length of the 
modulus, rather than more-or-less the 
length of the modulus as with RSA/ 
Whyte said. 

Her father, a mathematics instructor at 
the Cork Institute of Technology, has tried 
to place the achievement in some per¬ 
spective, "Sarah has a very good under¬ 
standing of the mathematical principles 
involved," he said, “but to call her a ge¬ 
nius or a prodigy is overstated.. / 


Paradhjms Past: 
Behind SWAC 

I t is an evanescent distinction to be 
called "the fastest computer in die 
_J world/ Scores of computers have 
earned that title over the past half- 
century, and some have held it for a 
very brief time. In 1950, the fastest com¬ 
puter in the world was die SWAC, die 
Standards Western Automatic Comput¬ 
er, the first computer built in California, 
(Hence the "Western/ The "Standards" 
part owed to the fact that SWAC was 
built for the National Bureau of Stan¬ 
dards.) Harry Huskey, the head of the 
team that built SWAC, had lived through 
Ohio winters Lind British winters (made 
somewhat brighter by the opportunity 
to work under the legaidary Alan Tur¬ 
ing), and he thought that California win¬ 
ters might lie an improvement It seemed 
to him diat the West Coast would be a 
line place to build a computer, and NRS 
had a lab at UCLA. Well, they had an 
empty room, anyway. SWAC, whose 
power supply alone took up a whole 
wall, needed a room, 

SWAC was built when transistors, 
operating systems, and programmers 
were unavailable, unreliable, or op¬ 
tional, and was built and programmed 
without benefit of any of the above. It 
was retired in 1967, when all three of 
these innovations were coming to lie 
regarded as necessary. Or unavoidable. 
In the meantime SWAC did a lot of use¬ 
ful work for NBS, and provided the 
material for a lot of reminiscences by 
Lhose who worked on it. One of the 
SWAC experts, Alex Hurwitz, found 
the then-largest known prime using 
SWAC. it saw service as an I/O device 
for an IBM 7094 and as an interactive 
personnel computer. And it served oth¬ 
er purposes. One system Operator re¬ 
members fondly the afternoon naps 
he took in the warm, dark spaces be¬ 
hind the bays of the huge SWAC, 

Try doing that with your Gateway PC. 

—MS, 


The algorithm is called the Cayley- 
Purser algorithm, after Arthur Cayley, a 
19th century British expert on matrices, 
and Michael Purser, a cryptographer from 
Trinity College, Dublin. Since the algo¬ 
rithm is based on matrices, the tribute to 
Cayley is understandable. He developed 
the algebra of matrices, published the first 
English contribution to the theory of de¬ 
terminants, and invented the notation of 
two vertical lines on either side of the ar¬ 
ray to denote die determinant. Purser is a 
modern mathematician, whose hest- 
known work may be his book Secure 
Data Networking (Artech House, 1993; 
ISBN 0-890-06692-2). 

The algorithm uses 2x2 matrices, where 
each entry is an RSA number. Because of 
this, the level of security it offers is ex¬ 
actly the same as ihaL of an RSA key with 
the same modulus. Bui die algorithm sub¬ 
stitutes a small number of matrix multi¬ 
plications for the modular exponentiation 
required by RSA, which is where it gees 
its speed. The trade-off, though, Ls a con¬ 
siderably longer key and ciphertext. At 
least that's what the Baltimore cryptogra¬ 
phers found. Maybe Flannery has im¬ 
proved on their work, but we won't know 
until she publishes. 

Five Fruit Flavors Ml 

I went to MacWorld Expo in January and 
subjected myself to the emanations from 
the best salesman in the industry. Here's 
what 1 found in my notebook when I 
came out from under the influence: 

Wasn’t that the Woz who cut across in 
front of me a few minutes ago while 1 was 
waiting in the Press/VIP line? Anyway, 
that’s Dan Gillmor of the San Jose Mer¬ 
cury News two seats down from me, so 
Eve got die same perspective as the Merc 
on this dog-and-pony show. Gillmor says 
something about the keynote not starting 
on Lime and 1 make some lame joke about 
all our watches automagically resetting 
themselves when Steve Jobs walks on 
stage. His legendary Reality Distortion 
Field, you know... 

Tlie show starts with a commercial, as 
Apple conferences often do, Hal 9000 
blaming Y2K on people w ho didn’t buy 
Macintosh. Jobs comes onstage to the 
same music that introduced the monolith 
in 2001. He lays out the specs for die new 
Yosemite line of G3 Macs. Up to 400-MHz 
processors; die first copper semiconduc¬ 
tor technology' in a commercial comput¬ 
er; built-in ATI Rage 128 graphics accel¬ 
erator; 16-MB graphics memory; GpenGL 
library; up to a Gig of RAM; up to three 
hard-disk drives inside the case for 100 
GB of internal storage; four slots of which 
three are 64-bit FG; 100 megabit Ether¬ 
net with 1-GB optional; USB and 
Firewire... 


Then he shows the machine. It’s beau¬ 
tiful. iMac colors, but a more sophisticat¬ 
ed, professional took. A door that makes 
access remarkably easy. Three really at¬ 
tractive monitors. Systems starting at $1599 
and available today. The colors and de¬ 
sign are, I suspect, way more important 
than most people in the industry realize... 

The big system software news is the gen¬ 
eral release of MacOS X Sewer. This is the 
server version of OS X, the client release 
being slated for later this year. It’s what’s 
left of Rhapsody, and it's a snapshot of 
where Apple’s at in terms of slipping 
NeXT’s UNIX kernel and other technolo¬ 
gy in under the Mac GUI to bring the Ma¬ 
cOS up to date. It looks like MacOS and 
seems to do tilings you wouldn’t expect 
From MacOS. Included? the NeXT Mach 
kernel, Apache, WelObjects, BSD 4,4, Java, 
$995 server license, shipping in February 
(didn’t quite make the Expo ship target). 
Bundling WebObjects is a big concession 
for Jobs, since this web app development 
software sells well now for thousands or 
dollars a pop. But is it the full WebObject? 
Skeptical minds want to know.., 

From the darkness at the back of the 
stage a huge rack rolls out with seven row r s 
of seven iMacs. The 50th is on the podi¬ 
um in front of Jobs, and all 50 are run¬ 
ning software disklessly from a single new 
Yosemite machine running MacOS X Serv¬ 
er. Jobs fires up a different full-screen 
video on each machine, and it is very im¬ 
pressive, Perhaps the most interesting 
point in the demo, though, is not die pow¬ 
er of MacOS X Server, but the fact that all 
LMacs run a tweaked version of the Mac¬ 
OS that allows them to boot from die net¬ 
work. Every iMac today lias a hard disk, 
but all the technology for a diskless iMac 
is apparently in place* Thin clients at a 
lower price arc only a decision away. The 
thumbprint of Apple Ixjard member Lar¬ 
ry Ellison is evident here.,, 

Okay, the color tMacs. The iMac, Jobs 
reminds die crowd, is die best-selling com¬ 
puter in America. 800,000 sold between 
August 15 and December 3T According 
to Apple’s December sales stats, about a 
third of those buying iMacs are first-time 
computer buyers, “the most coveted cus¬ 
tomers in the industry/ About three quar¬ 
ters of Lhe iMac buyers are not replacing 
another Mac. That means that Apple: 1. 
has made very credible inroads into the 
consumer market; and, 2 . has pushed be¬ 
yond its installed base.** 

The colors, the colors! Right, Five col¬ 
ors, all cool, all named for fruits. Avail¬ 
able right now r . Provocative new TV ads. 
Other iMac news or the lack of same pales 
in comparison, A price drop to $1199, 50 
percent more disk storage, a faster pro¬ 
cessor. Yadda yadda. * .No, it’s the color. Or 
the colors. 
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What’s the big deal about color com¬ 
puters? Jobs gets fairly silly raving about 
the colors. But I really think the iMac and 
Yosemite designs and colors mark some¬ 
thing new for the computer industry. A 
fundamental shift in die nature of the busi¬ 
ness. I wish I knew just what it was; Fd 
invest, but 1 have a theory'., „ 

Tlie rest of the keynote was alx>ut third- 
party' .software. Or what Apple is doing to 
support same. Getting John Carmack, 
founder of Id Software and God of Games, 
onstage to say that die Mac now had ev¬ 
ery tiling a game designer or player needed 
wasn't a bad move. Ditto licensing OpenGL, 
a move urged by game developers. And 
Connectix has a Sony Playstation emulator 
for die Mac. 1 sense a theme here.., 

The big hardware news, in terms of 
third-party opportunities, is that Apple is 
embracing standards and changing pro¬ 
tocols, PCI, USB, Ethernet, and Firewire 
device makers will benefit,., 

Color Reflections 

After die Expo, I saw a few T cracks in the 
image. Firew ire, hot technology though it 
may be, ran into immediate trouble when 
it became clear that Apple wanted to charge 
a pretty hefty licensing fee for it. If Apple 
doesn’t back off, die technology may not 
take off as quickly as Apple hopes— or 
needs it to. 

And I confess embarrassment at treating 
color as more significant than technology, 
bur I don’t recant. That is, I think dial the 
color and design decisions that Apple lias 
made are potentially more significant for Ap¬ 
ple and perhaps for the industry than any 
technical advance Apple could have made. 

Turning color and design into significant 
considerations in buying a computer takes 
die industry a step further in the direction 
of commoditization of die box. Commodi¬ 
tization is usually understood to mean in¬ 
terchangeable gray boxes distinguished only 
by price. But that’s not how people buy 
commodities; they do care abouL design 
and color, even—perhaps especially—in 
big-ticket items, like cars. Design matters 
in commodities. Color matters. 

Jobs is taking this fact seriously. No one 
has really clone this before. There have 
been color computers before, and there 
will be attempts to imitate the Apple col¬ 
on zation, but no one lias set out as de¬ 
liberately to transform the public percep¬ 
tion of what a computer is since—well, 
since die last two times jobs did it. 

This oughta be interesting, 

Transmeta Blarney 

There was some amusing disinformation 
on die Web not long ago suggesting that 
Silicon Valley’s most mysterious startup 
was going to apply its hot new technolo¬ 
gy to—w hich platform? Windows 2000? 


Linux? MacOS X? No, to the Amiga. At the 
risk of offending the Amiga community 
again, it was a pretty entertaining story, 
but apparendy entirely untrue. No disin¬ 
formation here, I hope, just a frank ad¬ 
mission of a lack of information Like most 
everybody in Silicon Valley, 1 don’t know 
what Transmeta is up to. 

Several facts are known about die hush- 
hush startup. Its address; 3940 Freedom 
Circle, Santa Clara. Its telephone number: 
408-327-9830. Its tantalizingly mute web 
site: http://www.lransmcta.com/. And the 
fact that it has hired Linus Torvakls, cre¬ 
ator of the Linux operating system. 

Okay, so maybe ifs not so mysterious. 
The stow is diat they make VLSI chips for 
the multimedia market. Really hot chips, 
IBM Microelectronics w ill be building chips 


for them in IBM’s state-of-the-art silicon fa¬ 
cilities, Fine, But why, then, is Transmeta 
hiring engineers skilled in kernel develop¬ 
ment and compilers? And what’s Torvakls 
doing diere, anyw ay? And Bill Rodriguez 
of die MIT A1 Lab's Project MAC? 

One person who probably knows all 
the answers is Microsoft cofounder and 
high-tech angel Paul Allen, who has in¬ 
vested heavily in the company, But l have 
a hunch he’s not talking. 

Next Month 

Come May, I’ll be on special assignment 
and, lor the first time in a decade, tliis col¬ 
umn will be absent, I will, however, re¬ 
turn In June, 

DDJ 
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The thing that makes Software Development '99 
so exciting is the very same thing that makes it 
different from any other conference, 

SD '99 is the only major forum for development 
professionals that is truly independent. Instead of a 
single point of view, you'll hear industry leaders 
representing a variety of technologies and a 
spectrum of competing visions. Then you'll 
evaluate and extract the truth for yourself. 

SD ‘99 isn't a marketing event It's about keeping 
developers ahead of the curve, well-rounded and 
more effective. Which is why, unlike any other, this 
conference has flourished for over a decade. 

This year, choose from over 200 classes and tuto¬ 
rials and test-drive the latest tools from over 250 
vendors. Join thousands of developers and their 
managers at the most critical event in the industry - 
the one that focuses on developing the developer. 
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( PROGRAMMING 


Java Jive and 
Scrolling the Editor 

Al Stevens 



W hat do you do when you live in 
a u dead spot 7 '? That's what AT&T 
told me. I live in a dead spot. It 
all started when I learned that for 
a flat monthly fee J could get a cell phone 
that includes some number of minutes of 
long-distance calls from anywhere to any¬ 
where in the continental US. and no 
roaming charges. My current service does 
not include the long-distance feature and 1 
pay roaming charges whenever 1 use the 
phone outside the reaches of BellSouth Mo¬ 
bility, Some simple arithmetic revealed that 
my average monthly long-distance hill and 
my local cell-phone charge would lie more 
than offset by the AT&T all-encompassing 
monthly charge. The roaming charge re¬ 
moval was an added incentive because i 
travel a lot, 

I called the local AT&T rep and signed 
up, He sent me a pocket-sized cell phone 
with instructions on how to set it up. It 
seemed to work except that my voice and 
die voice of whomever i called broke up 
a lot, so much so that meaningful con¬ 
versation was not possible. 

“Hell.,/ 

“Hi, thi... i—Al. 

“Wha.,.?” 

“Can I spea*. .to Char ..J 

“Wha.. .? 1 oi.. hear. . .You're break...... p.“ 

I called the AT&T sales rep who told 
me to call tech support (on my land line, 
of course). The nice lady who took my 
call Ix^an by asking how many stair steps 
do 1 have? This Is a one-story house,! an¬ 
swered, no stairs. No, no, she said, the 
cell phone has a little LCD stair step dis¬ 
play to indicate die signal strength. 'Hie 
picture of the phone on Lhe box ii came 
in had five stair steps, 1 didn’t have any 
stair steps on my phone. We discovered 
dial if I went to different parts of the house 
I could get one or two stair steps inter¬ 
mittently. Not enough consistent stair steps 
to complete a call. Do I have a tin roof? 
No, but I have a cat. She sent me out into 


Al is a DDJ contributing editor He can be 
contacted at astevens@ddj.com. 


my yard (my land line has a portable 
handset, so I took her outside with me). 
From my driveway l could get two stair 
steps more frequently than not. Would 1 
be willing to make all my calls from die 
driveway? No, we get a lot of rain. 

Finally, we agreed that t just don’t get a 
strong enough signal al my house. She 
asked when 1 1 live exactly and Llien blamed 
the problem on my proximity to Kennedy 
Space Center (15 miles away) and Orlando 
International Airport (40 miles away). All 
those antennae and low-flying aircraft and 
space shuttles, she said, 1 said diat was sil¬ 
ly, People use their ceil phones all over the 
airport and at the Space Center. You see 
them walking around making important 
calls all the Lime. After sending me a re- 
placement phone to try, which did not work 
either, AT&T decided that 1 live in a ‘'dead 
spot" and asked lor their phone liack. 

This is depressing. First, you are tofd 
you live in a dead spot, and you go into 
denial. Hi is lasts for a while as you see 
others using their cell phones in their cars 
and at tile mall, people who obviously do 
not live in dead spots. Eventually, you re¬ 
alize that you need help. The first step to 
ward recovery is to admit to yourself that 
you live in a dead spot. After that it’s one 
day at a time. I can't find any support 
groups or programs fur people who live 
in dead spots. If anyone of you has the 
same problem may lx* we can get togeth¬ 
er and help one another When you feel 
the effects of living in a dead spot getting 
the better of you, you can call me any 
time of the day or night, til hurry over to 
your house and stay with you until the 
crisis passes, during which we can get 
drunk together. Speaking of cell phones... 

What the Heck is java. Anyway? 

About 50 years ago, die Ink Spots sang, A 
bve coffee, I love tea. I love the java jive 
and it loves me. 7 ' Java jive. How prophetic. 
I thought Java was an improved program¬ 
ming language that looks something like 
C++ but with a more object-oriented pro¬ 
gramming model and fewer of the lega¬ 
cy C idioms that trip up programmers, a 


language intended to be interpreted and 
platform- independent so that programs writ¬ 
ten in Java can lx? run without dependence 
on a specific platform Tliafs what l thought. 

lhe "Preface” to The Jam ^Application Pr r+ 
gramming Interface, Volume l, (Addison- 
Wesley, 1996) by James Gosling, et al. says, 
Java is a general-purpose object-oriented 
programming language,* Hie book goes on 
to explain that java evolved from a language 
designed to write consumer device em¬ 
bedded applicatioas into one for writing 
platform-independent applets that could 
lx* run from within HTML pages by Java- 
enabled web browsers. This three-year-old 
explanation tends to reinforce what T 
thought. 

Recently on 60 Minutes, Scott McNealy, 
CEO of Sun Microsystems, said something 
that challenges that idea. When CBS cor¬ 
respondent Ijesley Stahl asked if java was 
going to make Windows obsolete, he said, 
"Windows is obsolete, 77 and went on to 
say that people don't need Windows any¬ 
more, that all they need is Java as the en¬ 
gine that drives their computer-based ap¬ 
pliances. He illustrated this notion with a 
cute little cell phone that opened like a 
dam shell to expose a tiny screen and 
keyboard similar to a Windows CE HPC 
device. Only it wasn't Windows CE, it was 
something else. Java, we are led to be¬ 
lieve, running a Swiss Army personal in- 
formation and communication device. 

fn an unrelated article alxxit Microsoft's 
problems with the Department of Justice, 
Charles Cooper of ZDNet Tech News said, 
"...this was a time when excitement was 
building [al Microsoft] around Java as an 
alternative to Windows, 77 

What? What are these guys talking 
about? Java can't be an alternative to Win¬ 
dows. Windows is one of the foundation 
platforms that support Java. The alterna¬ 
tives to Windows are UNIX, OS/2, the Mac 
OS, the embedded OS of your favorite ap¬ 
pliance, and so on. But these spin doctors 
seem to be telling us that Java is itself a 
full-blown operating platform and not a 
programming language that rides on some 
other language-independent platform. I ! ve 
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on bet* With IDLs ActiveX Control you’ll visualize your data 
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Multiple images of the Sun recorded pin 
a CCD came ml So ft X-ray [escape. 

Image courtesy of Lockheed's Solar and 
Astrophysit's Laboratory 

El Ninos rjjrrts arr studied by analyzing 
and vmuilizmg sea surface temperature 
data in I DC Data and image, from Oct. 
14, 1997, are courtesy of NGAAlNhSOIS 


Tor mid it thunderstorm simulation using I Did ActiveX control and OpenCL accelerated graphics. Image courtesy of 
foe Klcmp, Ph.D .„ NCAR. 
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display 3D MRI data with IDLs dicer tool 
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(continued from page 96) 
seen TV ads that convey that same false 
impression, too, as if there is some need 
to persuade the public to get on board 
and embrace Java instead of Windows. 
But then l read Sun Microsystem's own 
Java Platform web page (http://www.sun 
.eom/java/piatfoim jhtml), wli ich says; 

If you're reading this in a wel l browser on 
a personal computer or workstation, you’ve 
probably already got die Java platform. It’s 
incorporated into all major web browsers. 

So what am l missing? Give someone a 
computer and Java and what do they have? 
Nothing useful. Java needs more, something 
underneath, doesn't ft? java all by itself does 
not understand display devices, tile systems, 
pointing devices, and so on. In other words, 
it's no more or less an operating platform 
than C++ or Basic are operating platforms* 
You have to have an operating system. You 
have to have an operating environment "All 
major web browsers'' implies not only an 
operating system, but device drivers and a 
graphical user interface to integrate the dis¬ 
play and input devices into a common user 
interface anti onto the hardware platform. 
Then you need the web browser software 
itself on top of tine operating envlmnment 
and underneath Java. Which says that Java 
is at least two layers removed from Whi¬ 
tlows in the hierarchy of what you need to 
run programs on a PC. 

Am 1 wrong? No t Fm right, according to 
bun, itself In “What is the Java Platform?'’ 
(http://java + sun*<x>m/docs/w h ite/pla tform/ 
iavaplatfomi.docl.html), Sun says: 

The computer world currently has many 
platforms, among them Microsoft Windows, 
Macintosh, OS/2, UNIX and Net Wait 1 , what 
sets the Java Platform apart is that it sits on 
Up of these other platforms. | italics added! 

There is nothing particularly new and 
innovative about a language translator that 
sits on top of an operating system and in¬ 
terprets bytecodes (remember Pascal? 
SmallTalk?), but tine point Ls dial Sun s own 
online documentation contradicts what Mc- 
Nealy sp<x)n-ted to 60 Minutes viewers. 

Agreed, you don't need Windows specif¬ 
ically to run Java applets, but, on a PC, 
what are die alternatives? Linux and OS/2 
come to mind, but that's not Me Nealy's 
point when he says Windows is obsolete. 
He implied that his little multifunction cell 
phone and all the other Java-enabled con¬ 
sumer appliances—TVs, pagers, electric 
tt x >thbn ishes, v i brators, whatever — h ave 
eliminated the need for desktop PCs. which 
is why, in his view, Windows Ls obsolete. 
Windows Ls obsolete, he says, l because you 
don’t need the machine that Windows runs 
on. Maybe someone should make McNealy 
do a spreadsheet on that tiny keyboard; or 
write a report; or view anything of sub¬ 


stance on the wdx Maybe someone should 
explain to him the difference between his 
own Java Base Platform and the still- 
evolving Embedded Java Platform, which 
are described in the same web page. 

What I saw on 60 Minutes was typical 
flim-flam: McNealy confessing his techni¬ 
cally challenged background; McNealy giv¬ 
ing a speech while cruising the stage on 
roilerblades; McNealy playing hockey to 
show what a hard-driving, competitive 
guy he is; McNealy talking down-home 
trash and taking advantage of the relative 
technical naivete of the viewing public to 
promote his company's agenda, which 
these days is to bash Microsoft. Lesley 
Stahl bought it hook, line, and sinker, so 
maybe others will, loo. Not us program¬ 
mers, I'll wager. 

1 do not mean to fxdittle the importance 
of Java as a development platform that spans 
operating platforms and runs applications 
identically everywhere with the Internet as 
the ultimate operating platform I hope and 
believe that java* or something that falls out 
of it, will achieve that objective. But Java as 
an alternative to Windows? That's like buy¬ 
ing a steering wheel instead of a car, 

Editor Fixes 

In January, 1 introduced the Editor project, 
a programmer’s editor that I will eventual¬ 
ly integrate into Quincy 99, the Windows- 
hosted TDK that serves as a front end to a 
GNU C/C++ compiler, a project that 1 
launched in December (http;//www. mid- 
ifitz*cxxn/alstevens/quincy99/)-1 built a cus¬ 
tom editor class to support large text flics, 
which CEdii does not do, to provide a com¬ 
prehensive undo/redo feature, which CEd- 
it and CRicbEdU do not have, and to have 
an editor that is independent of die Win32 
API in case I decide to port Quincy 99 to 
a different platform some day. Having strug¬ 
gled with text editors in the past and be¬ 
ing aware of their particular problems, I 
wanted to use the std: container classes to 
implement text documents in memory. It 
.seemed that such an approach would make 
die problems of accounting for lines of text 
simpler to manage, I found that Lo be true. 

By now, several readers have down¬ 
loaded the editor (http://www,midifitz 
*ct >m/u 1st even s/ed i tc ir/) and expert ment- 
ed with it. Some sent comments and bug 
reports, which 1 addressed in code and 
uploaded. The most prominent problem 
was caused by my requirement to support 
longer files than CEdii could manage. 
Whereas I addressed the CEdii limit of hie 
size based on byte count, I failed to ad¬ 
dress a problem in the Win32 API that 
shows up with files that have a lot of lines 
of text. Until T heard from the readers, 1 
didn't even know that the bug was there. 
The solution is simple but was also un¬ 
known to me. 


The problem Ls with scrollbars and scroll 
thumbnail buttons. A program typically 
uses the CWnd:: Set Sc roll Range function 
to scL the range of values that represents 
the length (and width, too; I’ll just discuss 
the vertical scrollbar here) of a document 
as it relates to the scrollbar. Text docu¬ 
ments represent their lengths in lines of 
text. The program does this when it loads 
the document and whenever the number 
of lines of text changes because of edit¬ 
ing actions by the user The program dien 
uses the CWnd::SetScmUPos to set the po¬ 
sition of the thumbnail button to be some 
value within the range, usually the line 
number of the line of Lexl that Ls displayed 
at the lop of the window. The program 
does this whenever the user scrolls or 
pages the document* The problem is that 
those functions use int parameters to rep¬ 
resent the range and position, and inis 
under the Win 16 compiler were 16 bits. 
Since the run-time part of the API has to 
support Win 16 programs, the arguments 
are kept within the range of a 16-bit in¬ 
teger even though an int under Win32 is 
32 bits. The CWnd::OnVScroll and 
C Wmi:: Or i HScrolt message notific a t i on 
functions similarly report the scroll posi¬ 
tion as a 16-bit quantity. 

The solution, for which \ am indebted 
to readers Ben Constable and Gerald 
Schwartz, is to use CWnd::GetScrolUnfo 
and CWt id:: Set Sc roll!nfo. The application's 
overridden OnVScroll and OnHScroll func¬ 
tions ignore the UINTnPas argument that 
Win32 passes and call CWttd::GetSerollInfr 
to get the nTrackPos data member into a 
SCROLL1NFO structure to use as die scroll¬ 
bar's position. To set the thumbnail posi¬ 
tion, die program initializes the nMin and 
nMax data members of a SCROLLINFO 
structure and passes the structures ad¬ 
dress to the CWnd::SetScrollJnfo rather 
than calling CWnd::SeiScroltRange. 

Ben and M. Werner both reported a prob¬ 
lem with how 1 was dealing with die size 
of die Lext font, a problem related to plat¬ 
forms other than what 1 have here* They 
both offered code to correct the problem* I 
really like this kind of beta testing; the testers 
not only find die problems, hut diey fix them 
texx Doesn't leave much for me to do. 

Thanks also to reader Jean-Francois Pail- 
lard for reporting and fixing a really stupid 
hug. When 1 implemented the text search 
feature 1 included the ability to search for¬ 
ward and backward like most text editors 
do. The only problem was that 1 didn't 
bother to test the backward operation 
when searcliing for a string that does not 
exist in the text. Naturally, that was the op¬ 
eration that killed the program. Well, what 
else could you expect from a programmer 
who lives and works in a dead spot? 

DDJ 
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JAVA Q & A 


Are Java Applets 
Independent Programs? 



Steve Ball and John Miller Crawford 


A Java applet may seem to be an in- 
fft dependent program, but in one cru- 
mm rial aspect, it Is not. If you change 
mm a static field of a class used witliin 
an applet, that change pervades all 
applets — even if they ate on different web 
pages. Although, as we showed in “ Chan¬ 
nels for In ter-Applet Communication" 
(DDJ r September 1998), this behavior 
opens up a channel for inter-applet com¬ 
munication, such effects can be as un¬ 
welcome as they are unexpected. 

An example CAD system we wrote* 
called "WebCAD*” which lets models be 
built and displayed in 3D, demonstrates 
these unwelcome effects. (The complete 
source code and related files for WehCAD 
are available electronically; see “Resource 
Center,” page 5 ) First* consider this sys¬ 
tem implemented as a stand-alone Java 
application. Figure 1 shows two instances 
of tills application, in separate windows. 

At its lowest level, WebCAD deals en¬ 
tirely in polygons (or planes). The mod¬ 
el is displayed by drawing each plane in 
turn. Users can zoom in or out of the pic¬ 
ture by changing the scale factor* set the 
display to either wireframe or solid-object 
mode, and spin the object around its x- 
and y-axes by dragging it with the mouse. 
AJl of these sellings necessarily affect ev¬ 
ery plane in the model. 

In WebCAD, we use static fields in the 
Plane class to express these display 
properties—one for the scale factor, an- 
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izing in C++$aua/VNIX development. He also 
lectures in Obpct-Oriented Design and C++ 
programming at the Auckland Institute of 
Technology ; New Zealand, Steve can be con¬ 
tacted at steve^^ecdvefam.com.John is In¬ 
teractive Technology manager at Dai f Clark 
Design Associates and principal lecturer at 
the Auckland Institute of Technology. He am 
he contacted atphrun c@aiLac. nz, 


other for the display mode, and two to¬ 
gether for the current viewing angle; see 
Listing One. Tins is the alternative to stor¬ 
ing the display properties as nonstatic 
members in each Plane object* which 
would require iterating through all Plane 
objects and changing each individually— 
a task that is both tedious and needless¬ 
ly time consuming* since it would be 
meaningless for any two planes to be dis¬ 
played with a different scale factor or 
viewing angle. 

Used this w ay, static fields are fulfilling 
the role for which they were originally 
created in C++ (from which Java inherit¬ 
ed them). According to Bjame Stroustrup 
and Margaret Ellis in The Annotated C++ 
Reference Manual (Addison- 1 Wesley, 1990), 
“A static member function or variable acts 
as a global for members of iis class with- 
out affecting the rest of the program." 
They go on to say that since “a static data 
member [is] shared by all objects of a class 
in a program, 1 ” their scope is limited to the 
executing program. 

The consequence for WebCAD is that 
if we have two windows, each display¬ 
ing separate instances of it (see Figure 1)* 
we can change their display properties 
independently even while die planes in 
each separate model share the same 
values. 

In contrast, if we make a direct trans¬ 
lation of WebCAD to an applet and dis¬ 
play separate instances of it on separate 
web pages* we cannot make independent 
changes to their display properties. The 
browser executes applets as separate 
threads in the same Java Virtual Machine, 
so all applets share the same values of the 
static fields of any common classes. The 
scope of the static fields is not limited to 
the applet object or its executing thread, 
but encompasses all objects of the applet’s 
class* wherever they are instantiated by 
the browser. 


Figure 2 shows two applets experienc¬ 
ing just tliis problem. The models should 
lie in different scales and different display 
modes, but they both have identical ap¬ 
pearances. 

Reclaiming Static Semantics 
for Applets 

What you need for applets, then* is some 
means of resolving the sibling rivalry Uiat 
occurs when applets wish to have their 
own private copies of static fields. In this 
article, we present a workaround that lets 
the conventional semantics of static fields 
be reclaimed through the use of a spe¬ 
cialized mechanism Lhat mimics the be¬ 
havior of static fields. More importantly* 
tills workaround possesses die same mean¬ 
ing in both Java applications and applets. 

Ibis lets you develop classes that op¬ 
erate identically, whether instantiated with¬ 
in an application or an applet—something 
not possible if the classes use static fields. 
First, we present our solution in code form, 
and then we abstract its essence in the form 
of a design pattern. We ll also provide a 
set of rules that may he mechanically ap¬ 
plied lo a class that uses static fields, which 
will convert it to a class that is portable be¬ 
tween executing environments. 

Mimicking Static Fields 

Because static fields may not be used to 
store values particular to just one applet, 
it follows Lhat these values need to lxr rep¬ 
resented as instance variables in some ob¬ 
ject, The main Applet object is an excel¬ 
lent candidate for the custodian of these 
values, both because il sits al the root of 
the function call hierarchy and because 
there is only one per applet. 

However* the corollary to this decision 
is that in some form these values have 
to appear in every stack frame from the 
topmost to Lhe bottommost. We will dis¬ 
cuss Lhree ways to do this. 
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Figure 1: Independent objects in separate application windows. 
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First, they may be passed as construc¬ 
tor arguments to each class (see Listing 
Two) in the composition hierarchy. 

Eliminating Argument Clutter 

The second solution seeks to avoid the 
passing of long lists of values to a partic¬ 
ular class (such as Cube) with no other 
purpose than to allow that class to pass 
them on down. Instead, you can simply 
pass a reference to Lhe applet itself; see 
Listing Three. 

This approach of placing the values 
in the Applet object is adequate for many 
situations where objects depend upon 
global state values particular to just their 
applet Consider, for example, an applet 
that supports an HTML parameter that 
allows sound effects to be turned on or 
off. The setting of this value needs to be 
available to a variety of methods in a 
number of different low-level classes. If 
the value is stored in the applet during 
its initialization, then all objects with ac¬ 
cess to the Applet object are able to 
query it 

We recommend that you routinely pass 
life main Applet object as a constructor ar¬ 
gument to all helper classes. Then, when 
you discover you need to configure the 
applet s behavior at some low level based 
on a global value, you do not have the 
arduous task of retracing your steps back 
up the call hierarchy and inserting Applet 
references and constructor arguments into 
every intervening class. 


Emphasizing Relationships 
Between Classes 

The third approach is suitable for simple 
cases, particularly where global data (like 
sound-effects Hags) are not clearly owned 
by any one class (other than the applet). 

The disadvantage is that the Applet ob¬ 
ject, like the constructor argument list in 
our first solution, becomes cl uttered with 
the shared values from all the other class¬ 
es in the application that require applet- 
specific values to lie stored. Also, there is 
no explicit relationship between the mys¬ 
terious appearance of an instance variable 
in the Applet object and the class of the 
objects that depend on it. 



Figure 2: Interference between objects 
in the same browser window. 
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WebCAD is a good example of this, as 
there is a dear family tie between the 
Plane objects and the global properties 
that affect them ail. That structural rela¬ 
tionship may be expressed by encapsu¬ 
lating the display properties in a separate 
class, an instance of which is placed in 
die main Apple! object and passed (even¬ 
tually) as a constructor argument to each 
Plane object; see Listing Four. 

This relationship between a class (Poo) 
and die class that holds its static fields 
(FooProperties) mirrors the traditional rela¬ 
tionship lietween a class and its static fields. 
According to Stroustrup and Ellis, The as¬ 
sociation between the static mem hers and 
their class is explicit and obvious, where¬ 
as the use of global variables and functions 
for similar purposes is neither.” 

Intermediate classes (such as Cube) 
still have the task of passing on the 
properties reference (though they have 
no personal interest in it), but at least 
the ultimate destination class is obvious 
and documented in the code; see List¬ 
ing Five. 

The class that makes use of the applet's 
properties object ends up holding a ref¬ 
erence to it. The class (Plane, in this case; 
see Listing Six) refers to the display prop¬ 
erties by prefixing them with the name of 
the properties object, but otherwise treats 
them just as if they were static fields of 
die same class—which is effectively what 
they are, except they are not shared with 
other applets. 

Independent Applets in Java 

WebCAD is implemented as an applet that 
may be safely instantiated multiple limes 
in the same browser window without any 
unpleasant inter-applet interference. 

Figure 3 is a web page with two in¬ 
stances of the applet displayed. The in¬ 
stances have entirely different display 
properties: One has a wireframe appear¬ 
ance, the other is solid with hidden-line 
removal; one has been scaled down to 
80 percent of its initial size; and the mod¬ 
els are being viewed from different an¬ 
gles, This mechanism can be applied in 
any situation where a class wishes to have 
shared global values that are not affected 



Figure 3: independent objects in the 
same hrotvser window , 
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by other applets, and may be generalized 
in the form of the Shared Property design 
pattern. 


Intent. Allow the sharing of properties 
within a defined subset of the set of all 
objects instantiated from a class. 


Motivation. It is primarily in the con¬ 
text of Java applets that the Shared Prop¬ 
erty pattern is most usefully implement¬ 
ed, since web browsers' implementations 
allow Java class variables to be shared 
across applet boundaries. The Shared 
Property pattern mimics the behavior of 
static fields m classes executed within in¬ 
dependent Java applications. 
Applicability. Use the Shared Proper¬ 
ty pattern when undesirable side effects 
are produced by allowing the complete 
set of instantiated class objects to share a 
property (such as when executing within 
a browser environment). 

Structure. The Shared Property pattern 
is a composite of three classes: Shared- 
Properties, PropertySharer, and Property- 
Owner. Figure 4 shows the structure of 
the Shared Property pattern. 
Participants. SharedProperties, (Plane- 
Properties), the attributes to be shared by 
a group of objects; PropertySharer (Plane), 
an object belonging to the group sharing 
the common attributes; PropertyOwner 
(WehCAD ), the object responsible for the 
construction and storage of the common 
SharedProperties object. 

Collaborations. Clients access shared 
properties via a reference to the unique 
SharedProperties object, instead of through 
a static class variable of the sharing class. 
Intermediate classes in the composition 
hierarchy are obliged to pass on that ref¬ 
erence to the SharedProperties object un¬ 
til it reaches its ultimate destination in die 
PropertySharer class objects, 

Consequences. The Shared Property 
pattern allows the conventional behavior 
of static class variables to be reclaimed in 
an environment where static variables do 
not have their traditional semantics. 

implementation. The steps to con- 
vcrt a class that uses static fields to one 
that implements the Shared Properties pat¬ 
tern are: 

1. Extracting the shared properties. Extract 
any fields defined as static in the class 
to be convened (the PropertySharer) 
and place them in their own separate 
class (the SharedProperties class). The 
crucial step is to ensure that they are 
defined as regular members in the new 
class rather Lhan as static fields. 

2. Creating the shared properties object. 
Construct a single instance of the 
SharedProperties class as part of the ap¬ 
plet class's construction and record it 
in a private instance variable. If the 
values for the initial state of this object 
are not yet known, simply create an ol> 
jert using default values. Being shared, 
changes made to this object are made 
immediately apparent to members of 
the PropertySharer class, so initializing 
the values in the SharedProperties 



Figure 4: Structure of Shared Properly pattern. 
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object may be deferred until the point 
that the first PropertySharer object needs 
to use them, 

3, Making the shared properties accessi¬ 
ble, The SharedProperties object needs 
to be available wherever objects of the 
PropertySharer class are instantiated. 
The easiest way to achieve this is to 
pass a reference to the applet’s Shared- 
Properties object down [lie function call 
hierarchy through the constructors of 
any intermediate classes (or, alterna¬ 
tively, a reference to the Applet object, 
from which the SharedProperties object 
may be obtained). 

4, Associating the objects with their shared 
properties. Simply provide an additional 
argument to each of the constructors 
for the PropertySharer class. A refer¬ 
ence to the SharedProperties object 
should be stored in a private instance 
variable. 

5, Implementing Accessors and Mutators. 
Any existing accessor (get methods) or 
mutator (set methods) functions in the 


PropertySharer class, along with any 
other references to the erstwhile static 
fields, are modified to reference the 
fields In the Shared-Property object by 
prefixing them with the name of the 
SharedProperty instance variable. The 
accessors and mutators remain in this 
class and are not relocated in the 
SharedProperties class, so that use of 
the design pattern is as transparent to 
users of the class as possible. 

Conclusion 

Classes that use static fields with their tra¬ 
ditional semantics almost always give un¬ 
desired behavior when instantiated in an 
applet environment. To prcxluce portable 
code or to use static fields with their con¬ 
ventional meaning in applets, an alterna¬ 
tive idiom is required. 

We ve presented two possible solutions. 
For simple cases— and especially where 
a value is global to the applet and not par¬ 
ticular to any one class—the approach 
of storing the data directly in the main Ap¬ 


plet object and passing the applet object 
down to the other helper classes is con¬ 
cise, effective, and extensible* 

Where there is a deliberately exclusive 
relationship between a set of shared data 
and objects of a particular class, the Shared 
Property pattern is superior because, in 
addition to all the benefits of the first ap¬ 
proach, el explicitly establishes a tightly 
coupled relationship between the two 
classes* 

We recommend that you use either of 
the solutions we present even when pro¬ 
ducing classes targeted for stand-alone 
Java applications, so that if you wish to 
utilize those classes in an applet at a lat¬ 
er time, you may reuse them freely with¬ 
out having to make any modifications. 

The working Java applets from this ar¬ 
ticle may lie viewed at http://effectivejava 
,com/steve/iapps/ and at http://www.dcda 
. cg . nz/j mc/iapps/. 


DDJ 


Listing One 

class Flan* { 

static int diaplayMode; 

static double sealeFactor; 

static double rotation, elevation: 


Listing Two 

class WebCAD extends Appier I 
WebCAD (} £ 

cubes[01 - new CubetdisplayMode, staleFactot* rotation, 
elevation, Aether args*/)j 

3 

3 

class Cube C 

Cube Out diaplayMode, double scaleFactpc. double rotation, 
double elevation, Aother args*/) £ 
tapFace - new Pi atie (display Mode. ecaleFactor. rotation, 
elevation. Aether args*/) ; 

3 

1 


Listing Three 

claaa MebCAD extenda Applet £ 

WebCADf) { 

cubes [flj = new Cube {this, Anther arga*/); 

] 

] 

class Cube £ 

Cube{Applet applet* Aotber atge*/) [ 

tapFace = new FIane{applet, Aether args*/): 

} 

3 

dees Plane £ 

Plane(Applet applet, /‘other argat/3 [ 
this.applet = (WebGAD) applet; 

} 

void draw(Graphics g) [ 

switch (applet.displayHode) C 
case DM,WIRE.FRAME: 
case DM.SOLID.OBJECT! 

} 

] 

private WebCAD applet; 


Listing Four 

claaa PlaiuePtOpertieS £ 
int displayMode; 
double aealeFactar; 
double rotation; 
double elevation: 


PlanePropertiesfint diaplayMode, double scaleEactor, 
double rotation, double elevation) C 
this.diaplayMode = dispIayHode; 
this,atelelector = sealelector: 
this.rotation - rotation; 
this,elevation = elevation; 

3 

3 

class WebCAD extends Applet £ 

WabCADO f 

planepropertiea = new FlanePtopertiefl(plane.DM.WIRE.FRAME, 

1.0. INITIAL ROTATION, INITIAL ELEVATION); 
cLibea [0] - new CuhelplanePrOperties* /‘Other ergs*/) ; 

} 

private PlaneFroperriea plenePropetties: 


Listing Five 

class Cube £ 

Cube{PlanePrpportias plaheFrOperti&S, /bother arge*/) £ 
topFaco = new Plane(planeProparties. Aether ergs*/); 


Listing Six 

class Plane [ 

Plane(PlaneProperties planePrnperties* /‘other ergs*/) £ 
this-planeFropertiep = planeFroperties; 

3 

void draw(Graphica g) £ 

switch (planftFropertles.displayMode) £ 
case DM.WIRE.FRAME: 
case DM.SOLID.DBJECT: 

J 

1 

private PlanePrapertieS planePtopertieS; 


DDJ 
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ALGORJTHM A LLE Y 

Analysis of 
Algorithms 

Jon Bentley 



Y ou’ve just designed a nifty new al¬ 
gorithm, It’s fast, but exactly how 
fast is it? To help you find out this 
column presents tools and tech¬ 
niques tor analyzing the performance of 
algorithms. It starts with a simple program 
for an important problem, and improves 
it through several versions, 

1 originally presented versions of these 
algorithms in UnixReview magazine (June, 
1997). In the process, 1 observed huge per¬ 
formance speedyps— a factor of 30,000— 
but didn’t take the time to understand the 
details of the run times. This column ana¬ 
lyzes tlicxse algorithms, with an emphasis 
on methods that real programmers might 
use to understand performance. 

The Problem 

The Traveling Salesman Problem (TSP) 
calls for finding the shortest tour through 
a collection of cities. Figure 1 shows the 
shortest circuit through 14 cities that Abra¬ 
ham Lincoln visited when he rode the Illi¬ 
nois Eighth Circuit in 1850. This proto¬ 
typical network design problem often 
arises in applications such as scheduling 
mechanical devices and factory produc¬ 
tion lines. 

The fundamental mathematical ab¬ 
straction for dealing with the TSP is a 
permutation — an ordered sequence of 
objects. For instance, there are a total or 
six permutations of the three letters “a,” 
"b f n and “C: 

abc aefa bac bca cab eba 

In general, there are n! C n factorial”) 
permutations of n letters, where 
tt/=tfX(f?-l)x(rc-2)x.,.x3x2xL This is be¬ 
cause any one of the n elements can go 
in the first position, any one of the re¬ 
maining tt—1 elements can go in the sec¬ 
ond position, and so on down to the sin¬ 
gle remaining element that must go in 
the last position. The factorial function 
grows very quickly’ 


Jon is a Member of Technical Staff at Lu¬ 
cent Technologies } s Bell Labs. He can be 
reached at jlb@research . bell- labs , com , 


103=3,628,800, 

20!=2„43xl0 ,8 t and 
30!=2,65xl0 5Z . 

A TSP tour is a permutation of the in¬ 
put cities, Implicitly closed by the tour by 
traveling from the last city back to the first. 
Tile program tspl.c (and a sample input 
file, both available electronically; see “Re* 
source Center,” page 5) deals with n dries, 
where n is a global variable; bit n ; . 

The code won’t peek inside the repre¬ 
sentation of cities. Instead, it will access 
distances I between cities with the distance 
function 

typedef double Dist; 

Dist d(int i, ini j ) 

It will represent the tour in the vector p 
int p[MAXNj; 

where pf0..n-l] is a permutation of the 
cities in the tour. For instance, a tour that 
goes from city 3 to 1 to 4 then 2 (and fi¬ 
nally back to 3) would be represented by 
the permutation vector 3 1 4 2. 

Algorithm 1: The Easiest Program 

The first algorithm is easy; It will re¬ 
cursively generate all n! permutations, 
and choose die one w ith least cost. Be¬ 
cause it inspects so many tours, we can’t 
expect the algorithm to be fast; we’ll 
soon analyze it to see exactly him slow 
it is. Assume that the variables are ini¬ 
tialized with 

for (i = 0; i < n; i++) 
plij = t; 

m insum = INF; 

The name solve! denotes that this is the 
first version; 

void solvelO 
I searchl(n); 

I 

The workhorse is the following search 
function. The parameter m tells how 
many elements of the vector p have yet 
to be permuted. It operates top-down 
by leaving p[m.n-\] fixed while it per¬ 
mutes pfO.m-Xj: 


void search I ( im m) 

I ini h 

if (m = 1) 
check 10; 
else 

for (i = m-1; i >= 0; i--) | 

SwapCl ml); 
searchl(m-l); 
swapd, m l); 

I 

I 

The swap function exchanges pairs In the 
vector p< The for loop swaps each element 
in turn to the end, recurs with size m de¬ 
creased by one, then swaps the element 
back to its original place. This code is short 
but subtle, and is worth serious study be¬ 
fore proceeding. 

When a complete permutation is fixed, pi 
Ls 1 and searchl calls die check1 function: 

void check IQ 
I int i; 

Dist sum = d(p[0], pln-lj); 
for (i = 1; i < n; i++) 
sum d(pli-I] t p[il); 
sa vet sum); 


This function computes the cost of the 
tour by summing the n-\ distances be¬ 
tween adjacent points and adding in the 
distance from the last point to the first. 
The save function records the tour and its 
cost, if it is the best so far: 

void save(Dist sum) 

I int i; 

if (sum < minsum) I 
minsum = sum; 

For (i - 0; j < n; i++) 
minpfi] = p[il; 


The global variables rninp and minsum 
record the t^est tour and its length. 

How slow is this program? The run 
times listed in Table 1 were generated an 
a 200-MHz Pentium Pro machine. The 
first three times are observed values in 
seconds, and the final four times are 
back-of-the-envelope extrapolations. Tlie 
program is indeed pokey. 


Dr Dohh s Journal, April 1999 


107 







A little mathematics shows why it is so 
slow. The code investigates all nf permu¬ 
tations, and performs n distance calcula¬ 
tions for each (to calculate the cost of die 
tour). The total number of distance cal¬ 
culations used by the program is there¬ 
fore nxnf. 

Tlie analysis is confirmed by looking at 
a profile. Table 2 describes one run of the 
program with n= 9- This data confirms the 
analysts; The check 1 function is called nf 
(or 362,880) times. The distance function 
is called nxnf (or 3,265,920} times. This 



Figure 1: The shortest circuit through 
14 cities that Abraham Lincoln visited 
when he rode the Illinois Eighth 
Circuit in 1850. 


n 

Seconds 

S 

0.27 

9 

2.36 

10 

20.89 

11 

4 min 

12 

48 min 

13 

lOhrs 

14 

6 days 


Table l: Run times of Algorithm / on 
a Pentium Pro 200 , 


Fune 

Time 

% 

Hit 

Count 

Function 

13274.731 

64.6 

3265920 

_sqrt 

3403.500 

16,6 

3265920 

di$t 

1696.397 

8.3 

362880 

_check1 

1172.013 

5.7 

6531840 

_sqr 

554.196 

2.7 

623530 

_search1 

289.959 

1.4 

1247058 

_swap 

138.687 

0.7 

362880 

„save 

5.956 

0.0 

1 

_getgeom 

1,951 

0.0 

1 

_main 

0.002 

0,0 

1 

_so!ve1 


Table 2: Profile of Algorithm U 

n 

Dists 

Ratio 

2 

2 

_ 

3 

6 

3 

4 

24 

4 

5 

120 

5 

6 

720 

6 

7 

5040 

7 

8 

40320 

8 

9 

362880 

9 

10 

3628800 

10 


Table 5’ The distance calculations 
performed by Algorithm 2. 


profile also shows diat die distance func¬ 
tion is indeed the critical operation in this 
program: The dist function and the strand 
sqrt functions it calls account for almost 87 
percen t of the run time of the program. 

Exercise 1: Try profili ng a C implemen¬ 
tation of an algorithm. 

Algorithm 2: A Fixed Point 

The next algorithm reduces the run time 
by examining fewer permutations, it fix¬ 
es the last city in die permutation, and 
starts the search at one lower value: 

void solve2() 

{ seanehl(n-l); 

I 

This code no longer inspects all nf per¬ 
mutations, but still examines all possible 
tours. Algorithm 2 looks at only («-!)/ 
permutations, and performs n distance 
calculations at each. The total number of 
distance calculations is irx(rM)4 or pre¬ 
cisely nf. 

To verify this, well augment the dist 
function with instrumentation code dial 
gives key counts without the overhead of 
profiling: 

Dist dlstUnt i, int j) 

1 

rif COUNTDJSTS 
distent++; 

tfendtf 


n 

Alg 1 

Alg2 

8 

0.27 


9 

2.36 

0.33 

10 

20.93 

2.53 

11 


22,77 


Table 4: Run times of Algorithms 1 
and 2. 



Table 5: Run times of Algorithms /, 2, 
and 3* 


When the program turns on COUNT- 
DINTS, it increments distent at each call. (If 
the constant Is zero, no additional run-time 
overhead is incurred.) Table 3 shows the 
numlxT of distance calculations performed 
by the function. The first and second 
columns show that die number of distance 
calculations is indeed nf. The diird row di¬ 
vides the current number of distance cal¬ 
culations by die previous number. In this 
case, diose ratios repeat precisely the first 
column, and characterize factorial perfor¬ 
mance. 

Of course, it is always important to ver¬ 
ify that theory translates into reality; see 
Table 4. Both algorithms increase their run 
times by about a factor of n as n increases, 
and lire run time of Aigoridim 2 on n is 
a bit more dian Algorithm 1 on w-L Both 
of these observations are consistent with 
the predicted values. 

Algorithm 3: Sum Times Not 

'Hie next version of the algorithm reduces 
the overhead of computing the sum for 
each permutation from scratch. Instead, 
the code carries along the partial sum in 
a new parameter to the search^ function. 
It initially calls the function with the par¬ 
tial sum set to zero: 

void solverH ) 

I search3(n-l, 0); 

I 

It adds in the distance from the top city 
to the city next to it at each recursive call: 

void search3(int m, Dist sum) 

I int i; 
if (m ™ 1) 

check3(sum + dfpfO], p[l]»; 
else 

for G “ m-1; i >“ 0; i—) I 
swapti, m-1); 

search3(m-l, sum + d(p[nvlf plml)); 
swapG, m-1); 

1 

I 

The new checks function adds in the dis¬ 
tance from the first to the last city: 

void check3(Dist sum} 

I sum += d(p[0], pin-ID; 
savefsum); 


m 

c m 

m! 

Cn/m! 

1 

2 

1 

2,0000000 

2 

6 

2 

3,0000000 

3 

21 

6 

3.5000000 

4 

88 

24 

3,6666667 

5 

445 

120 

3,7083333 

6 

2676 

720 

3,7166667 

7 

18739 

5040 

3.7180556 

8 

149920 

40320 

3.7182540 

9 

1349289 

362880 

3.7182788 

10 

13492900 

3628800 

3.7182815 

11 

148421911 

39916800 

3.7182818 


Table d A spreadsheet for analyzing c m . 
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This algorithm still looks at (n -1 )/ per¬ 
mutations, and I guessed that it would av¬ 
erage roughly one distance calculation for 
each. I therefore expected another 
speedup of about a factor of n . Table 5 
lists the run times. Where I hoped for a 
speedup of around 10, I observed a 
speedup of just 2 or 3^ What gives? 

I enabled the operation counts, and ex¬ 
amined the sequence c m which denotes 
the count of distance functions used when 
the first parameter to search is m. I start¬ 
ed with small values: 

q = 2, c 2 = 6, C3 = 2L 
The sequence begins: 

2, 6, 21, H8, 445, 2676, 18739, 

My first approach was to check this se¬ 
quence in Neil Sloare's online encyclope¬ 
dia of integer sequences, but it wasn't there 
at the time. 

Exercise 2: Try looking up the sequence 
at Shane's iveh site at http:/Amnv.research 
Mt.com/-njas/sequences/. 

The next step involves finding a re¬ 
currence relation to describe the se¬ 
quence in terms of its earlier values. 
When m is one, there are two cities in 
ihe array and tile algorithm makes two 
comparisons (between that pair and from 
the first to the last): 2. When there are 
m> 2 cities, the algorithm swaps each of 
them to be the last, calls itself recursive¬ 
ly on size m -1 (at cost c m _i ), and then 
makes one additional distance calcula¬ 
tion for each: c m ^tnx(c m _[+!)■ 

I verified the first few values by hand, 
then used a spreadsheet to check larger 
values against the instrumented runs. 

Exercise 3: Dow would you construct 
that recurrence in a spreadsheets You 
may want to warm up by constructing 
the sequence ml. 

The recurrence matched the experi¬ 
ments. To understand the sequence, T 
toyed further with the spreadsheet. Be¬ 
cause I expected c m to be similar to fac¬ 
torials, the third column in Table 6 shows 
mL l next played with several different 
comparisons of the second and third raws: 



Table 7: Distance calculations used 
by Algorithm 4 . 


I subtracted c m from (m+l)f and took sev¬ 
eral ratios, all without insight. I finally 
stumbled across the ratio c m /m! shown in 
the fourth column, in which T at long last 
recognized a pattern. 

In high school, I memorized the nat¬ 
ural logarithmic base e to accuracy 
2.718281828459045...(Your guesses about 
my social life in high school may prove 
uncannily accurate.) My complete 
spreadsheet converged to 14 of those 
decimal digits at w=18, where floating¬ 
point accuracy finally gave out. This led 
immediately to the conjecture that: 

c m = m!x(l+e) 

But how does die ubiquitous e sneak into 
my T5P program? Subtracting one from 
the right column gives the sequence l, 2, 


2 1/2, 2 2/3which I recognized as die 
partial sums of the Taylor series expan¬ 
sion of e x evaluated at This suggests 
the theorem: 

c m =m!X( 1+1 /0E+1/1!+.. +l/(m-l)!) 

Exercise 4: Use mathematical induction 
to prove that this solution satisfies the re¬ 
currence relation . 



Table 8: Run times of Algorithms 3 
and 4. 
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This CD-ROM contains programs and libraries that are 
ready to run, and easy to install. 
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USE TCL/TK TO: 

■ Build web sites 

■ Perform regression testing 

* Act as an embedded command language 

* Create new a ppl rcations by integrating 
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applications 

■ Shrink development time with this 
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language 
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Exercise 5 Play further with a spread¬ 
sheet to discover additional patterns in the 
sequence c m . 

Because Algorithm 3 makes the orig¬ 
inal call search3(n-\, Q), it uses c„_, or 
approximately (w-l)/x(l+e) calls to the 
distance function. The speedup is not 
n, but rather roughly n/{\+e), which 
closely matches the experimental run 
times. 

Algorithm 4: Pruning the Search 

“Don't keep doing what doesn’t work" 
is good advice for programs as well as 
people. As die program progresses, sum 
can never decrease: Adding edges only 
increases the tour length. The program 
can therefore terminate the search when 
sum grows too large: 


void seardi4(mt m, Dist sum) 

( int i; 

if (sum > minsum) 
return; 
if (m == 1) 

... as before ... 

Each previous algorithm runs in die 
same time, for any size ft, regardless of 
the particular input data. The run time of 
Algorithm 4 varies dramatically with its in¬ 
put, Table 7 shows the number of distance 
calculations it uses on one sequence of 
inputs, where each input adds a single 
city of Lincoln’s tour By n=ll, pruned Al¬ 
gorithm 4 uses about a factor of 10 few¬ 
er distance calculations than Algorithm 3 
Furthermore, the ratios of distance calcu¬ 
lations show that the run lime does not 
increase by a factor of n at each stage, 



Table 9: A spreadsheet for Exercise 5. 



End the Chaos... 


The Discipline of Software Engineering. 


I Master of Software Engineering in Pittsburgh, 
New York City, and Washington, D.C, 


I Certificate in Software Engineering, graduate or 
continuing education courses by distance delivery 


Visit our website. 


but rather by a smaller factor (apparendy 
near 5 for diis range). As Table 8 shows, 
run-time experiments confirm Ixith pre¬ 
dictions. 

Algorithm 4 is much faster than Algorithm 
3, and its nin time grows more slowly, 
Exercise 6: Analyze Algorithm 4 in greater 
detail across a under variety of inputs. 

Tools and Techniques 

Programming tools and techniques for an¬ 
alyzing algorithms include- 

• Profilers, These general tools help us 
identify the key operations in code and 
their associated counts. 

* Operation Counts. After identifying dis¬ 
tance calculations as a critical operation, 
we added instrumentation code to count 
those operations, 

♦ Integer Sequences, You can analyze 
some algorithms by studying their op¬ 
eration counts with tods such as ratios 
and Sloane’s online encyclopedia of se¬ 
quences, 

* Spreadsheets. Spreadsheets provide a 
convenient way for storing and analyz¬ 
ing program performance data, 

• Mathematics, Detailed analyses can 
sometimes provide real insight into real 
programs. 

* Experiments and Common Sense. Al¬ 
ways run experiments to ensure that 
your theory matches practice. 

Stay Tuned! 

In my next column. 111 examine how 
Code-tuning techniques speed up the var¬ 
ious algorithms. 

Solutions to Selected Exercises 

Exercise 2, Although the sequence was 
not i here when I originally looked it up 
in April, 1998, ii has since been added, 
(Amazing how one sequence pops up in 
various contexts!) Hie encyclopedia now 
gives the recurrence, but nut the approx¬ 
imation derived in this column, 

Exercise 3 To compute m!, lirst set the 
A column to the integers 1, 2, 3,-*- Next set 
Bl to 1, then set B2 to =A2xRL and drag 
it down die B column. To compute c m set 
the first column as before, set Bl to 2, set 
B2 to =A2X(B1+1), and drag it down. 

Exercise 5. The first four columns in 
Table 9 are from the previous spreadsheet. 
The fifth column shows the difference be¬ 
tween elements in the fourth column, and 
the fifth column Is the inverse of the fourth 
column, I was delighted to see the facto¬ 
rials pop out in die fifth column. This is 
an alternate derivation of the fact that 
c m fm!= 1+1 /0/+1 /1 /+... +l/(m-lj/. 


DDJ 
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DR. ECCO'S OMNIHEURIST CORNER 


? 


Joints in Space 

Dennis E. Shasho 



G reat architects like Ecco. They rec¬ 
ognize his ability to solve lough 
structure and placement problems. 
The feeling is mutual, Ecco doesn't 
care much for glass towers or phony Vic¬ 
torian, but he holds a deep affection for 
Italian piazzas, well-designed airports, and 
clever approaches to traffic flow like the 
Guggenheim museum in New York or the 
Srnkai complex in Tokyo. 

The kinds of problems lie's attracted to, 
though, usually have lo do with extreme 
environments such as Antarctica or un¬ 
derwater cities, 

Jordan Tyler brought him such a prob- 
lem one fine winter day. Tylers reputa¬ 
tion had preceded him. A descendant of 
a famous railroad designer, he combined 
mathematics, architecture, and physics in 
all his creations. It was for that reason that 
a consortium of space exploration com¬ 
panies led by none Other than Mr. Nog 
Tugget (readers may remember this un¬ 
savory descendant of a ruined Alaskan 
gold rusher) had approached Tyler to de¬ 
sign a modular space station, 

Tyler's design specified rooms consist¬ 
ing of symmetric cubes 10 meters on a 
side w ith a single manhole-sized door in 
the center of each of Lite six cube faces. 

“We decided there was no reason to 
prefer one direction to another in space,” 


Dennis ; a professor of computer science at 
New York University ; is the author of The 
Puzzling Adventures of Dr. Ecco (Dover, 
1998), Codes, Puzzles, and Conspiracy 
(W.H. Freeman & Co., 19921 Database 
Tuning; A Principled Approach (Prentice 
Ha!!, 1992), and (coauthored uith Cathy 
La zero) Out of Their Minds: The Lives and 
Discoveries of 15 Great Computer Scien¬ 
tists (Springer Verlag, 1998). He can he 
contacted at DrEcco@ddj.com. 


Tyler explained. “In fact, I’d like to gel 
away from the idea of rooms altogether, 
but the oldtiiners want to be able to quar¬ 
antine areas in case of leaks or toxicity 
problems. TheyVe also asked me to help 
them design the interiors of the 48 cubes, 
but the first problem is how to arrange 
them and which company to place in each 
cube. That’s what I T m coming to you for.” 

“What have they told you about what 
goes on in the space station?” Ecco asked. 

“It is a deep commercial secret, it 
seems," Tyler answered. "All I know is 
that 15 companies are involved, each of 
which occupies one or more cubes that 
must be connected. Ill indicate this to you 
with a letter for each corporation, because 
their names are also secret/’ 

Company Number of rooms 

A 10 

B 1 

C 8 

D 2 

E 13 

F 2 

G 2 

H 1 

I 1 

J 1 

K t 

L 2 

M 2 

N 1 

O I 

"Also, certain pairs of companies, due to 
joint ventures, must have neighboring cubes. 
Here, I represent the necessary adjacency 
rektioaships in alphabetical order, For ex¬ 
ample, the fourth line says that some room 
of D must be next to some room of A and 
some (possibly different) room of D must 
lie next to some rcx>m of C t and so on for 
A F and G. There is some redundancy in 
this representation, but t hope it is clear. 


"Lack of adjacency imposes no con¬ 
straint, by the way, The fact dial 8 is not 
in the adjacency set of D, for example, 
means that it is not necessary for any ncxim 
of B to border any room of D, though this 
Ls allowed and even desirable. These com¬ 
panies engage in all manner of joint ven¬ 
tures and those joint ventures may require 
an exchange of materials within the space 
station.” 

A—B C D E F H I | L M 
B—A C 

C—AB D H GM 

D—A C H F G 

E—-A CDFGJKLMNO 

F—A D E | N 

H—A I L 

l—A IIJ L 

J—A E F t 

L—A E H T 

M—A C E 

G—G l)EK 

K—E G O 

N—E F 

O—E K 

“From your encoding, am we conclude 
M is a card sharp and K is an cm path?” 
asked Ecco with a smile. 

“Random letters produce tantalizing pat¬ 
terns," Tyler answered with a chuckle. 

“And when you say the 13 rooms oM 
must be connected, all you mean is that 
an astronaut am float from any room in 
company As space to any other without 
passing through any other company’s 
cubes?* asked Liane, 

“Correct/' Tyler said, nodding to the 10- 
year old. “As I said, they are all very jeal¬ 
ous of their secrets, more secretive in 
many ways than countries at war." 

Reader: Ecco and Liam succeeded in 
discovering a placement of the cubes in 
three dimensions and an assignment of 
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the companies to cubes that satisfied these 
constraints. Can you do it? 

After 7 + yler left, Bcco turned to me, 
“My dear professor/ 1 he said, “do you 
think it is possible to do better? 1 mean, 
can you find a design that satisfies these 
constraints but that establishes a proper 
superset of these adjacency relationships? 
If so, what is the design and what is the 
largest number of adjacency relationships 
you can find?" 

Reader: Would you tike to give it a try? 

Last Month's Solution 

When trains can carry only 50 passengers 
and all stations hold only two trains, tills 
is the best Ecco and Liane could come 


up with: 

Time 

Trips Started 

0 min 

DBC, EAR, ABF, BFE, FEA 

15 min 

CBD 

30 min 

GRA, BAE, AEF; EFBD* DBC* CBG 

45 min 

CBD 

60 min 

DBC, FBC, EFR, AFF 

75 mtn 

CBD 

90 min 

Some in transit 

105 min 

Everyone done 


When trains can carry 150 passengers 
atid station B can hold four trains, but all 
other stations hold only two trains, Liane 
suggested the following: Put the extra 50 
person train at station C, so C has two 
trains to start with. Further, assume the 50 
person train that used to start at B now 
starts at F, 

Time Trips Started 

0 FRAE (starts with 50 bound to A, 

picks up 100 passengers at B and 
proceeds to E after dropping 
passengers at A), DBC, CBD. 
AEF. EFRD (150 Load at E; train 
drops off 100 at B and carries 50 
to D), CRG (50 person train). 

15 G BA (50 person train), FBC (50 
person train) 

Traffic at Station B: 

time 0 — 0 

lime 15 — one from FA, one from DBC, 
one from CRD, one from CG 

time 30 —- one from EFBD, one from GC, 
one from FC. 

Reader Solutions to the Fair Swedes 
Problem 

Many readers found correct solutions to 
the Gutoldenborg map problem (DDf r Jan¬ 
uary 1999), most by "sitting at the kitchen 
table and scribbling" as one reader put it. 
Others used genetic algorithms, gradually 
refining the solution. Still others UuSed ex¬ 
haustive search, but more on that later. Fi¬ 
nally, Joe Celko managed to find a solu¬ 
tion in SQL — amazing! These readers sent 


me solutions: Juan Pitncorbo, Kerry D. 
Milica Pearl Pauling, Ralph Nebiker, Blaine 
Deal, Scot Billman, Michael S. VanVertloo, 
Jimmy Hu, Roger Alley, Michael Goldberg, 
Burghart Ho fine liter, Ernst Munter, Odd 
Tangen, Mike Robinson, John “Goodboy” 
Holland, Serguei Patchkovskii, Friedrich 
von Sol ms, Franco Venturi, Mark J, Mur¬ 
phy, Jeff Gerald, James Heginbottom, Bill 
Rooney, Jean-Philippe langlois, Bryan S, 
McDaniel, Jaeeo Kalman, Kakulidis 1 Li¬ 
lian, Joshua Lynch, Viktor Bresan, Peter 
Hansen* Mathew R. Davies, and Benjamin 
C. Chaffin. 

As Ralph Nebiker wrote, “This could 
be a really difficult problem if the 
boundary conditions and populations 
weren't quite so well defined. So, I de¬ 
cided to pursue that angle and per¬ 
suaded some respondents to try to find 
14 districts each having approximately 
12,000 people and to make it so that the 
maximum deviation from 12,000 was 
minimal*” 

The three best solutions to this second 
problem came from Roger Alley, Friedrich 
von Sol ms, and Serguei Patchkovskii 
(whose exhaustive search method used 
2.5 hours on a duster of 39 500-MHz 
21164 Alphas), The maximum deviation 
from 12,000 these solutions produced was 
a surprisingly low 29- 


Solution 
(11 48 64) 


Population: 11992 
(8 15 19 37 66) 

Diff: 8 

Population: 11975 
(2 14 36 40 56) 

Diff: 25 

Population: 12022 
(10 31 46 62) 

Diff: 22 

Population: 11996 
(12 27 43 57) 

Diff: 4 

Population: 11996 
(5 25 47 55 58) 

Diff: 4 

Population: 12(108 
(7 24 32 42 61) 

Diff: 8 

Population: 12005 
(1 23 28 45) 

Diff: 4 

Population: 12003 
(6 13 30 41 51) 

Diff: 3 

Population: 11996 
(3 17 21 33 52) 

Diff: 4 

Population: 12005 
(4 9 26 34 49) 

Diff: 5 

Population: 11971 
(22 38 50 59 65) 

Diff: 29 

Population; 11987 
(16 20 39 53 54 60) 

Diff: 13 

Population: 1202(1 
(18 29 35 44 63) 

Diff: 20 

Population: 12000 

DDJ 

Diff: 0 
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PROGRAMMER'S BOOKSHELF 


The General, 
the Particular, 
and the Just Plain Odd 

Gregory V. Wilson ond Steve [hartley 



Q| 


Electronic Review of 
Computer Books 


M ost of the computer-related books 
on my shelves fall into one of 
three categories: those that de¬ 
scribe how to do particular tilings, 
those that discuss why things ought to be 
done a particular way, and Lhose that can 
be summed up as saying, “Gosh, com¬ 
puters are really cool!" 

Tom Armstrong’s The Actim Template 
Library: A Developer's Guide is a perfect 
example of the first type. r fhe Active Tem¬ 
plate Library (ATL) is Microsoft's mast re¬ 
cent attempt to make its COM object mod¬ 
el more accessible. The library consists of 
a .set of C++ macros and classes that en¬ 
capsulate and partially automate basic 
COM operations. Both in spirit and in im¬ 
plementation, t3ie ATL is similar to die Mi¬ 
crosoft Foundation Classes (MFC), which 
serve the same purpose for Windows GUI 
programming, Instead of buttons* sliders, 
and message boxes* however, die ATL en¬ 
capsulates reference counting, dispatch in¬ 
terfaces, and threading. 

Armstrong's btxik starts with a short de¬ 
scription of C++ templates, and then de¬ 
votes a little over 60 pages to a discussion 
of what COM does and how it works. 
These two chapters are succinct, infor¬ 
mative, and easy to follow. The third chap¬ 
ter, which introduces the ATL, is harder 
going, primarily because die ATL is a com¬ 
plex library. Armstrong does his best, and 
provides some helpful diagrams showing 
the derivations and relationships between 
various ATL classes. However, I think that 
the chapter would benefit from more dis- 


Greg is (be author ^/'Practical Parallel Pro¬ 
gramming (NIFF Press, 1995) and coedi¬ 
tor tintb Paul Lu of Parallel Programming 
Using C++ (MIT Press, 1996), Greg can 
he reached atgmnhon@inXerkg.com. Steve 
is a developer with Visible Decisions Inc. 
and can be contacted at $tevec@vdLcom. 


The Active 
Template Library: 

A Developers 
Guide 

To m A rmstrong 
IDG Books, 1998 
447 pp., $39.99 
ISBN 1-3 58-$1580-1 

Multi Paradigm DESIGN 
for C++ 

fames O. Caption 
Addison-Wesley, 1998 
271 pp.. $34-95 
ISBN 0-201-82467-1 

Mr Bunny's Guide to ActiveX 

Carlton Egremont III 
Add ison-Wes lev. 1998 
112 pp., $14.95 
ISBN 0-201-48536-2 

Patterns in Java 

Mark Grand 
John Wiley & Sons, 1998 
'640 pp., $49.99 
ISBN 0-4712-5839-3 

cusston of die problems that various fea¬ 
tures are trying to solve, and from a slow¬ 
er pace in general. 

Each of die remaining eight chapters 
dissects one of the ATL’s key features— 
the use of IDL, containment and aggre¬ 
gation, automation, and so on. Each chap¬ 
ter begins by explaining why the particular 
feature exists, then walks the reader 
through an example, (The source for these 
examples is available at the author’s web 
site.) The two appendices discuss native 
support for COM in Microsoft's Visual C++, 
and the features that COM+ (COM’s suc¬ 
cessor) is supposed to have. 

Overall, 1 found Lhe Active Template Li¬ 
brary very useful: I'm trying to get up to 


speed with COM for a new project, and 
have been disappointed by how difficult 
most older bools make it. However, the 
book was weakened by a lot of irritating 
typographical errors, both in the text 
("pawwipg* instead of "passing,” for ex¬ 
ample, and some bad line splices), and, 
more importantly, in the code listings. 
Wliile I hope that a second edition ap¬ 
pears soon to fix these, the book is still 
the most readable technical introduction 
to the ATL Eve come across. 

James Coplieris Multi-Paradigm DESIGN 
for C++ (yes, that’s really how the title is 
capitalized) lives on the other tail of the 
bell curve for serious computing books, 
Coplien is best known lor his Advanced 
C++, a widely read book on how to do 
complex things in a language wliich is fair¬ 
ly complex in its own right. In this new 
book, Coplien moves beyond smart point¬ 
ers, the letter/envelope-design pattern, and 
the pitfalls of operator overloading to look 
at when and why you should use inheri¬ 
tance, templatization, function overbading, 
and the various other abstraction mecha¬ 
nisms that C++ now provides. 

Or at least I think that’s what he's do¬ 
ing, but to be honest, I’m not really sure. 
Multi-Paradigm DESIGN for C++ is writ¬ 
ten at such a high level of abstraction that 
1 often couldn’t tell exactly what point the 
author was trying to make. Occasionally, 
I would be able to seize on something 
concrete, such as the parallels between 
templatization, which give compile-time 
polymorphism, and the inheritance of vir¬ 
tual methods, which give run-time poly¬ 
morphism. Most of the time, though, l felL 
like J was in the presence of someone 
who’d had a glimpse of something fun¬ 
damental, but whose every attempt to put 
it into words ended up sounding banal. 
As depressing as it may be, I think I’m 
simply not smart enough, or experienced 
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enough, to understand what Coplien is 
trying to say. 

On the bright side. I’m pretty sure I un¬ 
derstood Carlton Egremont Ill’s Mr. Bun¬ 
ny’s Guide to ActiveX. 'Ihis book belongs 
in the ' computers are cool" category— or 
more exactly T in the “really gceky humor" 
category'. For example: 

The familiar dot V symbol from Internet ad¬ 
dresses is used in this book to terminate sen¬ 
tences. 

Well, okay, it’s funnier in the book. So 
is the side view of a dialog, and (my fa- 
vorite) the Visual Basic 5.0 splash screen 
on page 40, which looks suspiciously like 
a memory-access violation message box* 
Yes, die book runs out of steam about 
half-way through, but it's still very funny, 
and let's face it, where else are you go¬ 
ing lo read something like: 

...you form windows using forms. A form is 
a window that you form, At first forms an 1 un¬ 
formed. You must form your forms using the 
former designer (formerly tire former). In the 
form former, an unformed form forms a uni¬ 
form formation of dots. .. 

— G.V.W. 

I here is a quiet revolution under way 
in how we design object-oriented 
software. Reusable object patterns, 
first popularized in the hook Design 
Patterns, by Erich Gamma el al. (Addison- 
Wesley, 1995) arc changing the way we 
think alx>ut, talk about, and design object- 
oriented systems. Design patterns describe 
recuning problems and their core solu¬ 
tions in such a way that the solutions are 
reusable in different problem contexts. 
Design Patterns (also called the Gang-of- 
Four book, or just GoF ) has become re¬ 
quired reading for object-oriented de¬ 
signers, and has spawned its own virtual 
community, complete with an annual con¬ 
ference called PLoP attended by OO 
heavyweights, including the likes of Grady 
Booch, Frank Buschmann, and the GoF 
authors themselves. 

All this attention has made GoF the 
benchmark against which other pattern- 
oriented publications are judged. GoF, it¬ 
self, has been criticized for being difficult 
to understand. Since design patterns in¬ 
corporate both the problem and the so¬ 
lution, you really need an understanding 
of their problem context for them to make 
much sense. Good examples would real¬ 
ly be helpful here, but GoF is a bit thin 
on examples. The examples it does pro¬ 
vide are snippets of either C++ or 
Smalltalk, and neither of these is of much 
help to Java programmers. 

Tins i s where Patterns in Java, by Mark 
Grind, really fills a void. Grand adopts die 
format of GoF and restates its patterns us¬ 
ing Java. Pi] organizes 41 design patterns 


into six categories, (In contrast, GoF con¬ 
tains 23 patterns grouped into three cate¬ 
gories.) The extra patterns described by 
Grand are representative of the many ad¬ 
vances that have occurred in the three years 
since GoF was first published. Grand also 
presents a group of five “fundamental" de¬ 
sign patterns. These are object-oriented 
techniques described in the subtext of GoF, 
but not explicitly presented as patterns. 


Patterns In Java 
organizes 41 design 
patterns into six 
categories 


Grand also seizes an opportunity to de¬ 
scribe seven concurrency patterns that are 
conspicuously missing m GoF and ac¬ 
knowledged as such by its authors. 

As you begin reading PiJ, you get the 
.sense that one of Grand's goals is to make 
patterns more accessible to the everyday 
OO programmer In Chapter 1, he pre¬ 
sents a simple introduction to patterns, 
where he describes the nine topics that 
form the body of each pattern. This is a 
welcome simplification of ihe 12-topic 
structure used in GoF. In Chapter 2. Grand 
presents an overv iew of the Unified Mod¬ 
elling Language (l ML) that is used for di¬ 
agramming in PiJ, While UML Ls richer and 
more expressive than the notation used 
in GoF i 1 must confess that I prefer the 
simplicity of die GoF notation (for the de¬ 
scription of patterns, at least). The cardi¬ 
nality, type specification, and scoping ex¬ 
pressed in Pifs I. ML diagrams sometimes 
convey more detail than is necessary and 
obscure the simplicity of Lhe patterns. 

In Chapter 3, Grand makes a concession 
to methodology, by presenting an overview 
of ihe software development process. Tills 
Ls essentially a 10-page introduction to UML 
“use cases" and the requirements for spec¬ 
ification. analysis, and design, which form 
the framework of every software develop¬ 
ment project. You've probably read this 
kind of tiling liefore, but the review still 
gets you in the mood For what follows. 
Each of the remaining six chapters in 
PiJ describes a collection of related pat¬ 


terns, Chapter 4, “Fundamental Design Pat¬ 
terns," describes Five basic patterns that 
form the building blocks for other pat¬ 
terns. Chapter 5, “Creational Patterns, 15 de¬ 
scribes six patterns for implementing dy¬ 
namic, decision-driven object creation 
mechanisms. Chapter 6, ''Partitioning Pat¬ 
terns,” describes three patterns that pro¬ 
vide guidance in how to partition com¬ 
plex functionality into multiple, loosely 
coupled objects. Chapter 7, “Structural Pat¬ 
terns, 7 presents nine patterns for manag¬ 
ing complex arrangements of objects at 
run time. Chapter 8, “Behavioral Patterns/ 
describes 11 patterns that organize and 
combine the behavior of objects to pro¬ 
mote reuse. Chapter 9, “Concurrency Pat¬ 
terns/ p resen ls seven patterns for coor¬ 
dinating concurrent operations, like 
controlling access to shared resources, and 
ordering die sequence of execution. 

There is considerable debate within 
the pattern community as to what con¬ 
stitutes a proper definition of "design pat¬ 
tern.” GoF's stature within the pattern 
community dearly makes it the reference 
definition for design pattern. But with 
each new pattern publication, the defi¬ 
nition of design pattern seems to broad¬ 
en. For example, some will argue that 
Grand s interface pattern is not a pattern 
at all, but is instead simply a feature of 
the Java language. In my opinion, this is 
a red hening issue. The real benefits that 
PiJ , GoF, and other pattern catalogs of¬ 
fer is that they convey know ledge about 
object-oriented problems and solutions. 
By defining u standard format, the.se pub¬ 
lications make this knowledge widely ac¬ 
cessible and reusable, which has long 
been the Holy Grail of object-oriented 
architecture. So, whether Pifs patterns 
conform to GoF’ s definition of design 
pattern, by applying Pifs techniques, 
your Java projects will benefit from im¬ 
provements in scalability, reusability, and 
maintainability, PiJ is well written and 
reasonably easy to understand. It’s also 
one of the few pattern publications that 
Ls truly Java centric. If for no other rea¬ 
son than this, Patterns in Java deserves 
two thumbs up. 

=S.C. 
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* Drag unit Drop Visual Prugriiiiiirthlg. 

* t'lNnfrfcliccmvi: Suppuri fur N-Dimriutijcukl, Mull lispuctmi Duimti. 

* Kirii dltxlian of well-documented tSO tiUS? il'IKSt bused 
focussing Operamm. 

-Rich API fin Developing your own Dr^i arid I3rcip module*; usiiii! C ur C++. 

P,CS. Bus ZK(Vi TeL +47 llVtoAm 

1^, Dynamic N70G2 TromJteim Fu: +47 73516325 
* Illl l^jn^ AS B-Mall: Halcst^dvn.niriic-imagiiif'.nri 

Web: bt[p ^/wwWf.dytuuinic-liiiii^tiig-iiu 


Zip and Unzip from your apps with [he 

XCEED ZIP 

COMPRESSION LIBRARY 


* Easy to use VBX, OCX and VCLs 

* Fast, compact and reliable 

* Over 40 Zip and Unzip functions! 

* AIM6 & 32-bit controls for $199.95 
New self-extractor add-on for Xccod Zip tets your 
apps create customized 16/32-bit self-extracting 
Zip files, Only $99 with purchase of Xceed Zipt 


Get the fully functional free trial version! 
wwwiXceedsoft.com'dobbs 


| Xceed Software 1 - 600 - 865-2626 1 - 450 - 442-2626 M 


mmmmm mm £> 


mime + + 

.. a most complete and essential class library " 


Licensed by 

Fortune SOT companies . 


* 


... and around 
the world t 


document objeci model lor MIME 
C++ library 

tuny standards compiian! fRFC &22, £045. £040. & more) 
SMTP, POP, NNTP 
source code available 

Hunnv Software * 001)94a -6999 
www.hunnysoft.com/MIMEPP 


Predict Software Speedup 


FREE software accurately predicts the 
code speedup possible from 
parallelization* 

Download at 

1 1 tip: if w w w. m y nas .com/pred i c tor/free 
Call (780)435-1000 


Myrias Software Carp. 



html++ Supports 

CGI Class Library ISAPI 

Compatible with all internet web servers 
Generate interactive web pages in C+ + 
ideal for webifying data bases 
No mare Perl or scripting 
Automates CGI, cookies, forms, state 
Win32, Winl 6, OS/2, DOS, Unix, Mac 

FREE DEMO Call 1 - 800 - 775-1073 | 

rsem nr KA* T&l (678)442-1623 

LJL m I cro Fox {fi7S 442 ^ S1 g 

kmicro.com 


Dr. DssBra* ODBC Driver Kit 

The Easiest way to Create an ODBC Driver 


j An ODBC driver for your database connects users lo 
] desktop favorites like MS Access, and Visual Basic. 

* Full Source Code Included 
■ 2 to 4 weeks Development Time 

* No ODBC Knowledge Required 

* Network Version Available 

* Royalty Free Distribution 

ISYWARE, Inc. www.syware.com 617 497-1300 



► New Version 2.1. 

► Generates documen¬ 
tation. directly from the 

source code, 

► Extracts comments. 
► User cust omized 
reports formats, 
► HTML, WrnHelp, 
RTF. 

► FREE working 
evaluation at 
w w wJbbees oft .com 

ft 


Generate Documental ion 
from your source code with DocJet f 


Produce HTML, 

MSI I dp, and 
MS Word 

(lijcumeiiuitjfrn from 
nmuncnts in yumr 
wnk - jutd wttil 

flut'd l» fkan^t' yew 
cipmmcntftg stylet 



FREE TRIAL, VERSION! 
http : if w ww.fa I 1-trtexo m 
i n foetal I-512-453-4909 













































































































Where do 
you find 

116,000 

professional 

software 

developers... 

monthly? 

in 



DDJ subscribers are 
among the most 
technically 

advanced programmers 
in the field. 


EDUCATION 


J c 


PROLOG TOOLS 


Address for Success 


r i http://www.uics.edu ^ 


■ Earn 0.S. and in Computer Science 


AMERICAN 


NEW B. S. program in Information Systems XNSJIXUTE 

* Distance Education 

* Object wiefited'B.S. pragwn 

* Approved by more Ifmn 275 companies 

* Follows ACWIEEE guidelines 

* Thousands of students ihroughout U.S. 

Free catalogue 1-800-767-AICS 

Or www.aics.edu 



Add Rule-Based 
Components 


Diagnose, advise, configure and plan 
with the Amzif* LogicServaF tools & 
libraries (DLLs) for C/C++, Java, VB, 
Delphi, Web Servers & more. Win NT 
95 3.x & Solaris. Use ODBC t Sockets, 
Unicode & new OOP extensions, 
FREE Evaluation Version! 
Afltzi inc. Email info @ amz i .com 






( GRAPHICS LIBRARIES ) 

C _ SECURITY ) 





New Version Q S3DQ 

VICTOR 


Im age Proce ssin g Lib rary 

Fast BMP, TIFF, PCX, GIF, TGA, PNG, JPEG Adjust 
brightness, contrast, sharpen, create fitters, resize, rotate, 
♦more of single image, multiple Images, or any image area: 
color reduction to optimum, specific, or sld, palette; print; 
scan; crop, combine, compare, blend images. 

DOS $199, Id-bit DLL $299, 32-bit Dti $ 499 
Catenary Systems 
314-962-7833/fax: 314-962-8037 
www. catena ry. co m/vlcto r 
asR for free demo sre avail visa/mc/c.o.d. 




Reliable Software 


Cost effective products for all 
levels of software protection 
and authentication. 

• CRYPTO BOX ' 1 brand dangles, 
SmartCard, PC Cards, and extension 
cards # Software based metering 
systems • Active, (XIX & VCL 
components 




SOFTWARE SECURffV 


1-800-627-9468 

770-986-8887 
FAX: 770-986-8891 


www.marx.com 


c 


IA V A TOOLS 


Linux * OS/2 * Solaris - NT ■ HP-UX ■ MacOS * AIX 

Sim pj^jgU y 

Build professional Java apps ^ 
visually on the platform 
of your choice. 

* v 

FREE TRYOUT - 100% Pure java 



Smartcard Solutions 


^/ii 


'Qrfc 


Th eSMAR X-Card Developer's K i t - 

provides every thing needc d to X r\~ 

create smartcard applications 1 f IQ 
for the next millennium. 

• Easy to implement under DOS and 
Windows • Controls access to PC/ 
data/network • Protects and meters 
software • Secures electronic com¬ 
merce * Supports ISO 7316 ahdT- 
0/1/14 » Compatible with Microsoft 
PC/SC « 

1-800-627-9468 

770-986-8887 
FAX: 770-986-6891 






■ r\r\ . SOFTWARE PROGRAMS 

LOOkinfl to partners in profit! 

You provide ttie compiled Small Business, SOHO, Financial, 
Personal Productivity or “how-to" software program. E-Z Legal 
Software will provide packaging, duplication, marketing and 
sales personnel to generate royalty checks lor you. 

With distribution in more than 6500 retail outlets, ws have 
the experience lo launch, market and sell your program at retail 

3t ™ cos1 to y° UI Dennis Liptrol: 1-80D-B22-4566 


384 8. Military Trail, Ovirfitld Beac h. F L 8344 2 
photld (954) 4B0-BS33 * Fas (954) 480-8905 i 
h (tp-;//www-fl -jle gal, coni — d)iplrDt®e-zteg3l.eom 


C and C++ DOCUMENTATION TOOLS (v„ 7.0) 


* C- CALL ($69) Graph Mm of talter.i'calted h 


' C-CMT (563} Dreiilei’inseiis.'Liixlaiescommffnt-biiskaUtincLiWis.'ldenlilittt 
LiScdi lor meIi furiutlDii. 

1 C-WETRtC ($59| CalculHles palh cumpiDwly, counts line? witti comments, cod 
V atatemenls 

1 fi-LIST |$G9| Lists and acncn-diaafams,, er reformate soured into u 


CR£F 1589] Creates crosg-ffiference ol locakgltfOaydBftrw/pwameter l 
• C DOC |$l M) PACKAGE AIF 5 prolans F'ltopiukiu as BPS propfam. <1G,QD0 
UK C- BROWSE Windows qrapfiic-lrea vtswer 
C-oOC Fratotkaml ($299) ms winom. osa. i wm.ooos am* 

HEWVEH7 0! WEB HTML ffiP0«T5r 


SOFTWARE BLACKSMITHS IHC. «™ N ® swcscom 
6064 SI Ives Way, Mississauga Voice/Fa* (905) 558-4466 
OWT Canada L5N-4M1 http://www.swbs.com 
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The masl recent version of NobleNet’s 
Nouveau Object Request Broker (ORB) 
provides direct COM T CORBA, RPC, and 
Java support, without bridges or wrap¬ 
pers. Nouveau was also designed to work 
directly with firewalls. The latest version 
of Nouveau features Portable Object 
Adapter (POA) support, Naming Services, 
embedded CORBA, and a C mapping. 
Nouveau runs on Windows NT/95/98, So¬ 
laris, AJX, SCO-UNIX, and 1IP-UX. 
NobleNet Inc, 

337 Turnpike Road 
Southboro, MA 01772 
508-460-8222 

http://'www.nobleneteom/ 

SourceOlBite Professional Edition Version 
hi is a remote access tod designed ft w com- 
panics with remote development teams that 
need fast and secure access to a centralized 
SourceSafe dataliase via a TCP/IP connec¬ 
tion. Version IT features data compression, 
additional project level features such as Pro¬ 
ject Checkout and Checkin, and a 56-bit en¬ 
cryption build for international users. 
SourceOIBite 
6 Dunlap Court 
Savoy, 1L 61874 
217-356-3213 

http:// www. sou rceoffsite.com/ 

Topanga Software has announced Topan- 
ga SdiematicMaker, a tex >1 for creating elec¬ 
trical schematics, flowcharts, diagrams, fa¬ 
cility maps, and tables. The Technical 
Edition costs 579*99, and the Business Edi¬ 
tion costs 549.99. 

Topanga Software Corp. 

200 Suburban Road, Suite A l 
San Luis Obispo, CA 93401 
805-546-8088 

http: //www ? , topangasoftw a re,com/ 

Instan[Objects has introduced Instant- 
Objects, a web application development 
platform for developing, deploying, and 
maintaining dynamic, e-business web sites. 
The [nstantObjects platform Features In- 
stantModeler, a GUI for managing the dy¬ 


namic dcuiuiLS of the site; InstantDatabase, 
which manages the insertion, real-time in¬ 
dexing, and rapid extraction of data; In- 
stantCommerce, a GUI for specifying bill¬ 
able items and events; Instant Extractor, 
which parses structured or unstmaured data 
and moves it to InstantDatahase- In- 
stantServer, a Java web application server; 
and InstantSite, a library r of sample user in¬ 
terfaces. The InstantServer operates on 
UNIX, Windows NT, and MacOS, 
InstantObjecLs Inc. 

651 Brannan Street 
San Francisco, CA 94107 
415-284-5300 

I ittp://www. instan [objects, com/ 

Micro Focus has announced Net Express 
3.0, a development environment that aids 
the rehosting t>r CoIxjI applications to the 
World Wide Web. Net Express 3.0 includes 
an Internet Application Wizard, that builds 
Internet client/server applications from a 
database schema, HTML Forms, or exist¬ 
ing G>lx)l applications; Form Designer, an 
HTML and DHTML Forms editor; CORBA 
Wizard For Orbix, which generates a Cobol 
client and wrapper for a CORBA object; 
and remote debugging. Net Express 3.0 
sells for $3650.00 
Micro Focus 

701 East MiddleFIeld Road 
Mountain View, CA 94043 
650-938-3700 

htt p://www. m icrc jfocus. com/ 

Raima has released Velocis Database Serv¬ 
er 2.1, which includes new interfaces for 
multiple development environments, in¬ 
cluding Rogue Wave's DBTods.h++ 1 Perl, 
Java, and Delphi. Other changes include an 
integrated repair tool called “dbrepair,” SQL 
functions that support scrollable cursors, 
and an ANSI SQL extension that supports 
development of sophisticated multilingual 
or "Soundex” features, Velocis Database 
Server Ls available on Windows NT/95, AFX, 
BSDi, HP-UX, Linux, SCO, and others. 
Raima Corp. 

701 Fifth Avenue 
Seattle, WA 98104 
206-515-9477 
http://www.raima.coni/ 

Digital Delivery announced Confidential 
Courier 2.1, a turnkey software system For 
controlling who accesses which files and 
at what times. Version 2.1 allows compa¬ 
nies to distribute the same set of secured 
files, contained in an encrypted Courier- 
PAR, to different recipients while control¬ 
ling which recipient can unlock which file 
or file set. Version 2.1 Features two new 
optiona 1 add- ons — CourierPAR App- 
Aware and CourierPAK Access Period— 
that let users control how and when se¬ 


cured files are accessed. The CourierPAK 
AppAware option permits the author of a 
document to designate which application 
recipients must use to open the Courier¬ 
PAK. The CourierPAK Access Period op¬ 
tion allows companies to further safeguard 
confidential information by specifying a 
time window in which files can be viewed. 
Confidential Courier 2.1 is available on 
Windows 3-1/95/98/NT. 'llie basic software 
product is priced at $2995.00, with the 
CourierPAK AppAware and CourierPAK 
Access Period options each costing 
$495.00. The complete file security and 
management package, including all op¬ 
tions, and key server, Ls priced at $8980.00. 
Digital Delivery Inc. 

54 Middlesex Turnpike 
Bedford, MA 01730 
781-275-3830 

I iltp://www. digi ta Ideli very, com/ 

Flashline.com, an online retailer of Java- 
Beans and other software components, has 
announced its global Developer Database 
Program. Flash line's Developer Database 
Program matches developers to companies 
with project proposals. You can enroll in 
the program For free at Flashline's web site. 
Flashiine.com 

1300 East 9th Street, Suite 1310 
Cleveland, Ohio 44114 
216-861-4000 

I I Up:// www. Has h lin e .com/ 

Baltimore Technologies has released Ver¬ 
sion 2.4 of its UniCERT Certification Au¬ 
thority (CA) system. Tile version works with 
a wider range of systems, has an enhanced 
policy management system, and supports 
new standards and regulations, including 
PKIX-1 and various national regulatory re- 
qu i rumen Ls. Version 2.4 adds support For 
Automated RA systems built using Balti¬ 
more PKl-Plus, which enable enterprises to 
build certificate enrollment systems where 
authentication is provided by another IT 
system rather than a human operator. 
Baltimore Inc. 

101 East Park Boulevard, Suite 600 

Plano, TX 75074 

972-516-3744 

http://www h ball I moreinc.com/ 

Cqgnet announced the latest version of its 
proprietary software distribution tool, Cognet 
3.0, which provides an end-to-end solution 
for transporting, packaging, customizing, 
and delivering software applications. Gpgnet 
features a refined “delta" technofogy, intel¬ 
ligent uninstall, and automatic installation to 
a fresh copy of Windows. New features in¬ 
clude a three-tier client/server architecture, 
multilevel security, a keystroke recorder, and 
Profile and Distribute NT System Services. 
G>gnet works with Windows 95/99/NT, and 
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directly supports NT Server as well as Net¬ 
Ware 3 4x t and 5.x. 

Cognet Corp. 

465 Columbus Avenue 
Valhalla, NY 10595 
914-747-0770 
h ttp; // w ww ( cognet, com/ 

The Stingray division of Rogue Wave Soft¬ 
ware lias announced its Objective Toolkit 
for WFC 2.0, which includes support for 
advanced docking windows and toolbars. 
Objective Toolkit's docking windows sup¬ 
port creates a framework that makes any 
component dockable and any area a deck¬ 
ing target. The docking toolbar support 
builds on the docking window support, al¬ 
lowing toolbars to tie docked along any side 
of the application windows or float as a sep¬ 
arate window. Objective Toolkit for WFC 
2,0 also features several additional control 
enhanoenients, all integrated with Microsoft’s 
Visual J++ development environment. Ad¬ 
ditional features include Border Layout, Split 
Layout, Listbox Edit, and Scrolling View, 
Objective Toolkit for WFC 2 + 0 sells for 
$495.00, and includes full source code. 
Rogue Wave Software Inc. 

5500 Flatiron Parkway 
Boulder, CO 80301 
303-473-9118 

hi t p://www. roguewave. com/ 

ObjecTime Limited has announced Devel¬ 
oper TestScope, which adds testing and 
debugging automation capabilities to the 
ObjecTime family of tods for the real-time 
software developer. Developer TestScope 
works by first transforming software com¬ 
ponent behavior requirements into sets of 
rest cases. It then generates a test frame¬ 
work and executes die tests. The results of 
each lest are presented in a graphical form 
showing any differences between the re¬ 
quired behavior and the actual behavior. 
ObjecTime Limited 
340 March Road 
Kanata, ON 
Canada K2K 2E4 
613-591-3535 

http://w w w .object ime. com/ 

Perl Direct from ActiveState Tool is a Perl 
support program designed for corporate 
IT managers. Perl Direct features validat¬ 
ed, quality-assured releases of Perl and its 
popular extensions, advice and support, 
a Y2K test suite, incident-based support 
through the Perl Clinic, and a Perl Alert 
weekly bulletin. Basic annual subscription 
rates start at $12,000.00. 

ActiveState Tool Corp. 

P.O. Box 2870 Main Station 

Vancouver, BC 

Canada V6B 3X4 

http://www .activestate.com/ 


JLOGX 1,0 from LOOX Software is a dy¬ 
namic graphics and data visualization de¬ 
velopment tool for java programmers, 
JLOGX lets Java programmers create high- 
performance user interfaces based on the 
Java 2D rendering API. By providing a set 
of high-level graphics components built 
on the Java 2D API, JLOOX lets develop¬ 
ers create high-end graphical interfaces 
that go beyond the capabilities of Swing, 
JLOOX includes JLOOXMaker, an inter¬ 
active editor for creating complex static 
or animated graphical control objects. 
JLOOX 1.0 sells for $2500.00 for a single- 
user development license, and has no run¬ 
time fees or royalties. 

LOOX Software Inc, 

4962 El Camino Real, Suite 206 
Los Altos, CA 94022 
650-903-0942 
http: //www. loox, com/ 

NeoLite from NeoWorx is a compressor for 
Win32 executables. Compressed programs 
execute directly, with no separate decom¬ 
pression step. Compressed candidates in¬ 
clude EXE, DLL, OCX, and ActiveX files. 
NeoLite sells lor $128.00, and is royalty free. 
NeoWorx Inc, 

P,Q. Box 969 

Flat Rock, NC 28731 

828-697-7901 

http://www, neoworx, com/ 

Mb Software has announced a freely avail¬ 
able, online reference to popular, reusable, 
open source and public domain software 
functions, libraries, and applications. Ilie 
comprehensive index, located at http:// 
www.mibsoftware.com/re use/, links d i- 
rectly to home and archive sites where 
source code is available. 

Mib Software 
HR 4 Box 4110 
Saylorsburg. PA 18353 
717-992-8824 

h ttp: //www. mibsoftware .com/reuse/ 

TeamShare’s release TeamTrack Version 3 0 
is the most recent version of die company’s 
problem-tracking system for software- 
development teams. Using TeamTrack, soft¬ 
ware teams can track and prioritize defects, 
customer requirements, change requests, 
and other issues that arise during software- 
devefopment projects, all over the Web. New 
features include Folders, Version Control In¬ 
tegration, Threaded Notes, and Remote Ad¬ 
ministration. TeamTrack Version 3-0 costs 
$4994)0 for a single-user license, with vol¬ 
ume discounts available. 

TeamShare Inc. 

1975 Research Parkway, Suite 105 
Colorado Springs, CO 80920 
719-599-4444 

hup ://www, teamsh are. com/ 


The Barcode Suite from Sky Line Tools 
Imaging is a barcode recognition toolkit 
for Delphi, Visual Basic, and C++. Using 
a fuzzy logic algorithm for image recog¬ 
nition, Barcode Suite identifies and de¬ 
codes most of the widely used barcode 
standards. Barcode recognition is done 
from a black and white 1-hit image. The 
Barcode Suite currently comes as a DLL, 
and costs $1999,00. 

Skyline Tools Imaging 
20537 Dumont Street, Suite A 
Woodland Hills, CA 91364 
818-3464200 

h ttp://.skylinetool s.com/ 

Lassalle Technologies released Version 2.1 
of AddFlow, its flowcharting and dia¬ 
gramming ActiveX control. This new re¬ 
lease now features complete printing and 
previewing capabilities. The AddFlow con¬ 
trol allows the creation of diagrams, whose 
objects—-links and nodes— are fully cus¬ 
tomizable. An AddFlow diagram can be 
used to display application data and for 
knowledge navigation. Drawings may be 
done interactively or programmatically. 
AddFlow costs $299.00. 

Lassalle Technologies 

247, Avenue du Marechal Juin 

92100 Boulogne 

France 

33 1 46 03 42 20 
h i Lp: //www, la ssa lie. com/ 

KL Group Inc, released J Cl ass SwingSuite, 
a suite of JavaBean components for build¬ 
ing graphic user interfaces. [Class Swing- 
Suite provides a set of extensions and en¬ 
hancements for Swing in TDK 1,2. Features 
include MDI to manage multiple windows 
inside applications and sophisticated Wiz¬ 
ards to guide users through complicated 
tasks. [Class SwingSuite includes over 20 
thread- friend!y, 1 ightweight components 
for adding features such as proper resiz¬ 
ing behavior to applications, an advanced 
mukicolumn uutliner, progress manager, 
enhanced tree views, and spin boxes. 

KL Group Inc. also released the 2,0 ver¬ 
sion if J Probe, its Java profiling tool. This 
release includes new heap analysis toots 
for finding and eliminating memory leaks, 
JProbe works with the Solaris and Win¬ 
dows versions of the Java Development 
Kit 1.1 and 1.2 + 

KL Group Inc, 

260 King Street East 
Toronto, ON 
Canada M5A 1K3 
416-594-1026 

http://'www. klgroup. com/ 
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SWAINE'S FUMES 



Death Rattle 

Y ou have to be taken to Foo Bar the First time you go; you'd never find it on your own. 

Tucked away at the end of what looks like a Fire trail amid dense undergrowth beneath a 
stand of redwoods some 1800 feet above Silicon Valley, it can't l>e seen from any vantage 
point and has no view. That's how we like it, those of us who hang out here late evenings to 
argue the burning issues of the day, most of us journalises, most of us cynics, 

I work here one or two nights a week as a relief bartender. On this particular moonless night, 
it was as dark as die grave outside, and just as cold. If die temperature dropped another eight 
degrees, that cold drizzle could actually turn to snow. Customers were huddled over their drinks 
as though to draw heat from them, and conversation was desultory. Then Joe “Curly Joe" Weaver, 
a sort of marginal journalist who writes for inflight magazines and drinks cream soda, brought up 
the Intel boycott 

“It's just Lhe coolest thing!* he gushed. “Privacy advocacy groups are calling for a total boycott 
of Intel products, until Intel changes its position on putting digital IDs in its chips. You know 
those IDs could be used to track people wherever they go on the Internet. It’s Big Brother! But 
the people aren’t going to stand for itP 

Joe is, denizens of Foo Bar generally agree, insufficiently cynical. But there are cynics and there 
are cynics, British journalist Laurence "Larry” Wilde manages to express disdain for practically 
everything with that typically British understated pretension that we Americans mistake for dry wit. 

Tm dry, Michael/' Larry' said, raising a witty eyebrow' and glancing at his glass. I filled it with a 
chardonnay that left it only slightly less dry. “Granted their cause is just/' he said, turning to Joe, 
Their method strikes me as more than a touch quixotic. A boycott of Intel products? So 1 don't 
use my laptop today; how does that hurt Intel?” 

Maureen “Mo* McBean is a cynic in the classic American reporter mold. “Privacy” she said t 
pausing for dramatic effect and to finish off her Haig & Haig, “is dead” She banged the glass down 
on the bar. 

Larry tilted his head to take her in. Ti certainly is making a lot of noise," 

“That's death rattle/' she said, pushing her glass toward me for a refill* 

“Death rattle? A typically charming Americanism, but its meaning eludes me/' 

Joe jumped in, “Has to do with snakes, doesn't it?” 

“No. no/ Mo murmured. Hi’s a noise made by a corpse. Sometimes things are louder after they 
die than before. Like nationalism and Biblical literalism/' 

“Technically/ I said, jumping in before any nationalists or Biblical litcralists who might be in 
the bar could take offense, “death rattle occurs before or at the point of death, not after*” 
“Whatever The point is, privacy is as dead as a mackerel/ 

“Or as dead as Prodigy Classic?” joe offered, “Prodigy just shut down its Classic service* Blamed it 
on Y2K problems." 

“More death rattle/ Mo said. “Prodigy Classic has l^een dead a long time/ 

Larry pinched his nose thoughtfully. “Actually, ’dead as a mackerel' may be dead as a 
metaphor* Some Japanese chap has come up with a way to ship fish alive, using acupuncture. 
Poke them with a needle and the mackerel or salmon catch a nap on their way to the sushi bar, 
where they arrive as fresh as if just caught, although, one imagines, a bit more relaxed. 

Interesting idea, though, that Y2K thing. One could hold seminars on it; Blaming Y2K as a 
corporate public relations strategy*"' 

Joe cut in. “There's a bigger threat to the Net than Y2K, you know.” 

“Marc Andreessen becoming chief technology officer of ADD*” Larry guessed. 

Joe shcx>k his head. “No, Slates trying lo regulate it. Predictions arc there'll be over a thousand 
new- Net law's proposed this year in State legislatures/’ 

Mo drawled, “Someone should tell them about the concept of interstate commerce/ 

“Well/ Larry .said, “if China and Germany and the United States think they can regulate Net 
content, why not the States? It s a difference in degree, not in kind* Wrong t licit not innovatively so/ 
“Politicians. They're all dead from the neck up/ Mo said. 

Larry smiled. "Ah, but lx?ware their death rattle/ 



Michael Swaine 
editor-at-large 
msvvaine@swame.com 
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FAST DATABASE 
ROYALTY FREE 






Fort t# NT,M, 91 

UNIX, MAC... 



JsaiSsai js|m| 

' a ^jr Hgy 

Awonf-Winrong fte^formonce 5 /ears In a rowi 


© 1999 Scquiicr Software 3nc, All rights reserved CodeBase and Sequlter are registered trademarks of Sequiter Software Inc. 

All other product names are trademarks of their respective companies. 


Loaded with 
features... 


Multi - Language 

CodeBase 6.4 works with C. C++. Visual Basic, Java, Delphi, 
ODBC and OLE DB. 


Incredible Speed 

Query a million records in 0.49 seconds. Append 1 Q r 000 
records in just 0,65 seconds! All this speed m a super- 
compact library that uses very little memory. 


Royalty Free 

Includes standalone, client and server. 


xBASE Compatible 

Multi-user file compatible with FoxPro, dBASE and Clipper 
data, inde* and memo files. 


Client/Server 

Advanced security features. New easy-to-use tools for 
monitoring database activity and managing user access. 
Incredibly easy installation and setup! 


Portable 

Runs under Window 98,95, NT. CE, 3.1, DOS. Mac, OS/2, Solaris, 
SunOS, AIX. SCO, Linux, UnixWare, DEC Alpha, BSDI, HRAEL 

Enterprise-Level Power 

Includes transaction processing, logging, backup and recovery 
tools, and intelligent queries. 


And More.... 

Data-Aware controls, full-featured report writer and free 
technical support Add-ons available for OLE DB, ODBC and 
Delphi BDE plug-in replacement. 

FREE 30 Day Test Drive 

Test drive the new CodeBase 6.4 for 30 days 
with vour own code. No risk. No obligation. 
No royalties. Order today! 

Call: 780-437-2410 


Web Site: www.sequiter.com 


SEQUITERII 

SOFTWARE INC. 1111 

Fa x: 780-43 6-2999 ErnaiJ: e nfo @$eq u I ter. co m 
RQ, Box 783 , Greenland, NH 
In Europe calf:( 44 ) ! 8 t- 316-5001 



















Develop, debug and deploy professional Java 
applications and servlets in record time with 
powerful productivity features: 

* Two-way drag and drop programming environment 

• Superior JFC/$wing support with native compilation 

* lava Code Helper provides auto syntax checking while coding 

• Sophisticated JavaBeans and interaction support 

* 200+ professionally developed JavaBeans plus source code 

• World-class incremental, remote and servlet debugging 

* Powerful database functionality including Query By Example 
(QBE), SQL and stored procedure support, multiple column 
databinding, open JDBC development and moreJ 

• Industry's fastest JIT compiler 


Special Limited Time Offer when you buy Visual Cafe! 
For details, see www.visualcafe.com/vc3/offer 


For pricing on 


site licenses, call 


Symantec Cohm? rate Sales 


at 1-8S8-822-3409. 


Stimtart Edition 


□ m 

US2GI ORACLE 


Professional Edition Dalahase Edition 


VisualCafe is available at the fallowing retailers: BEST BUT® • CompUSA- * Fry’s Electronics » J&R Computer World * MICRO CENTEfT 
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The next generation of the #1 selling Java IDE. 


SYMANTEC. 













